MD_QA/README.md

20 lines
1.2 KiB
Markdown

# Quality Assurance Settings for museum-digital
Most of the code used at [museum-digital](https://www.museum-digital.org) is written in PHP. To keep a uniform code style throughout the code, we use [PHP Code Sniffer](https://github.com/squizlabs/PHP_CodeSniffer).
## Tools used
- [php-codesniffer](https://github.com/squizlabs/PHP_CodeSniffer)
- [PHPStan - PHP Static Analysis Tool](https://github.com/phpstan/phpstan)
- [phpunit](https://phpunit.de/)
## This Repository
This repository serves to collect generally applicable rules, that can be embedded into the specific rule sets of the different projects.
The file [`md_phpcs_rules.xml`](./rules/md_phpcs_rules.xml) contains the main style guide. When rewriting files to fit the uniform style rules, ``[md_phpcs_rules_basic.xml](./rules/md_phpcs_rules_basic.xml)`` comes in handy as a first step. It contains the same rules, excluding some which require or encourage a more in-depth look at the code (the prohibition of procedural-style calls to mysqli functions is e.g. a good opportunity to check the efficiency of queries).
## License
This project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for the full license text.