README

Create more accessible forms in your PHP apps.

What does this library do?

This library helps you create accessible forms within your PHP app. It uses Symfony Form as the underlying form library.

It includes:

• Accessible form themes
• Support for the GOV.UK Design System
• Error summary block
• Update page titles on form validation errors
• An HTML block for inserting custom HTML into forms

Each feature is explained in the docs. Usage instructions for Symfony and Laravel are included.

Requirements

• PHP 8.2+

Installation

You can install the package via Composer:

composer require studio24/accessible-forms

See usage instructions for Symfony and Laravel.

Local install (remove this on release)

During testing you can install this from a local copy via:

Edit .ddev/docker-compose.mounts.yaml and run ddev restart:

     "repositories": {
        "local": {
            "type": "path",
            "url": "/home/accessible-forms"
        }
    }

Update Composer to point to your local repo:

composer config repositories.local path "/home/accessible-forms"
composer require studio24/accessible-forms:dev-main

To remove this after testing:

ddev composer config repositories.local --unset
ddev composer update

And remove the DDEV mount from .ddev/docker-compose.mounts.yaml

See https://github.com/studio24/dev-playbook/blob/main/composer/testing-local-packages.md

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Find out more about how to contribute and our Code of Conduct.

Security Issues

If you discover a security vulnerability within this package, please follow our disclosure procedure.

About

This package is developed by Studio 24, a human-centered digital agency who build websites and web apps that work for everyone.

License

The MIT License (MIT). Please see License File for more information.