CodeIgniter Coding Standard
This library holds the official coding standards of CodeIgniter based on PHP CS Fixer and powered by Nexus CS Config.
Installation
You can add this library as a local, per-project dependency to your project using Composer:
composer require codeigniter/coding-standard
If you only need this library during development, for instance to run your project's test suite, then you should add it as a development-time dependency:
composer require --dev codeigniter/coding-standard
Setup
To start, let us create a .php-cs-fixer.dist.php file at the root of your project.
use CodeIgniter\CodingStandard\CodeIgniter4;
use Nexus\CsConfig\Factory;
return Factory::create(new CodeIgniter4())->forProjects();
This minimal setup will return a default instance of PhpCsFixer\Config containing all rules applicable for the CodeIgniter organization.
Then, in your terminal, run the following command:
$ vendor/bin/php-cs-fixer fix --verbose
Adding License Headers
The default setup will not configure a license header in files. License headers can be especially useful for library authors to assert copyright. To add license headers in your PHP files, you can simply provide your name and name of library. Optionally, you can also provide your email and starting license year.
-return Factory::create(new CodeIgniter4())->forProjects();
+return Factory::create(new CodeIgniter4())->forLibrary(
+ 'CodeIgniter 4 framework',
+ 'CodeIgniter Foundation',
+ '[email protected]',
+ 2021,
+);
Providing Overriding Rules and Options
The list of enabled rules can be found in the CodeIgniter\CodingStandard\CodeIgniter4 class. If you feel the rule is not applicable to you or you want to modify it, you can do so by providing an array of overriding rules to the second parameter of Factory::create().
Similarly, you can further modify the PhpCsFixer\Config instance returned by using the available options. All available options are fully supported by Nexus CS Config and abstracted by simply providing an array of key-value pairs in the third parameter of Factory::create().
-return Factory::create(new CodeIgniter4())->forProjects();
+return Factory::create(new CodeIgniter4(), [], [
+ 'usingCache' => false,
+])->forProjects();
You can check out this library's own .php-cs-fixer.dist.php for inspiration on how it is done. For more detailed documentation on all available options, you can check here.
Contributing
All forms of contributions are welcome!
Since the rules here will be propagated and used within the CodeIgniter organization, all proposed rules and modifications to existing rules should have a proof-of-concept (POC) PR sent first to the CodeIgniter4 repository with possible changes to the code styles applied there. Once accepted there, you can send in a PR here to apply those rules.
License
This work is open-sourced under the MIT license.
14 Dec 15, 2022
11.6k Jan 3, 2023
9.9k Jan 4, 2023
46 Dec 7, 2022
50 Jan 6, 2023
462 Dec 22, 2022
24 Aug 27, 2022
393 Feb 25, 2022
309 Jan 3, 2023
1 Feb 21, 2022
2 Oct 10, 2021
767 Jan 2, 2023
2.7k Jan 5, 2023
17 Jun 16, 2022
39 Dec 14, 2022
12.4k Jan 8, 2023
2.7k Jan 2, 2023
1 Nov 27, 2021
5 Feb 2, 2022
1 Jan 15, 2022
1 Jan 30, 2022
33 Dec 15, 2022
3 Apr 13, 2022
37 Dec 19, 2022