Skip to content

Commit 379b821

Browse files
author
github-actions
committed
bump to v3.67.1
1 parent 8f29dcf commit 379b821

File tree

346 files changed

+997
-991
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

346 files changed

+997
-991
lines changed

404.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@
3131
<div class="clearfix">
3232
<div class="logo_header"><a href="/">PHP Coding Standards Fixer</a></div>
3333
<h1 class="title_header">
34-
<strong>Persian Successor (v3.67.0)</strong> edition
34+
<strong>Persian Successor (v3.67.1)</strong> edition
3535
</h1>
3636
</div>
3737
</div>

doc/config.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@
2727
<div class="clearfix">
2828
<div class="logo_header"><a href="/">PHP Coding Standards Fixer</a></div>
2929
<h1 class="title_header">
30-
<strong>Persian Successor (v3.67.0)</strong> edition
30+
<strong>Persian Successor (v3.67.1)</strong> edition
3131
</h1>
3232
</div>
3333
</div>
@@ -60,7 +60,7 @@ <h2>No config<a class="headerlink" href="#no-config" title="Permalink to this he
6060
</div>
6161
<p>It is also possible to provide command line options to customize rules, yet instead of using them,
6262
it’s recommended to save the project configuration in a <code class="docutils literal notranslate"><span class="pre">.php-cs-fixer.dist.php</span></code> file in the root directory of your project.
63-
The file must return an instance of <a class="reference external" href="https://github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/v3.67.0/src/ConfigInterface.php">PhpCsFixer\ConfigInterface</a>
63+
The file must return an instance of <a class="reference external" href="https://github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/v3.67.1/src/ConfigInterface.php">PhpCsFixer\ConfigInterface</a>
6464
which lets you configure the rules, the files and directories that
6565
need to be analyzed. You may also create <code class="docutils literal notranslate"><span class="pre">.php-cs-fixer.php</span></code> file, which is
6666
the local configuration that will be used instead of the project configuration. It

doc/cookbook_fixers.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@
2727
<div class="clearfix">
2828
<div class="logo_header"><a href="/">PHP Coding Standards Fixer</a></div>
2929
<h1 class="title_header">
30-
<strong>Persian Successor (v3.67.0)</strong> edition
30+
<strong>Persian Successor (v3.67.1)</strong> edition
3131
</h1>
3232
</div>
3333
</div>

doc/custom_rules.html

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@
2727
<div class="clearfix">
2828
<div class="logo_header"><a href="/">PHP Coding Standards Fixer</a></div>
2929
<h1 class="title_header">
30-
<strong>Persian Successor (v3.67.0)</strong> edition
30+
<strong>Persian Successor (v3.67.1)</strong> edition
3131
</h1>
3232
</div>
3333
</div>
@@ -55,7 +55,7 @@ <h1>Creating custom rules<a class="headerlink" href="#creating-custom-rules" tit
5555
<p>If you need to enforce some specific code style rules, you can implement your
5656
own fixers.</p>
5757
<p>For each rule you want to add, create a class that implements
58-
<a class="reference external" href="https://github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/v3.67.0/src/Fixer/FixerInterface.php">PhpCsFixer\Fixer\FixerInterface</a>.
58+
<a class="reference external" href="https://github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/v3.67.1/src/Fixer/FixerInterface.php">PhpCsFixer\Fixer\FixerInterface</a>.
5959
Note that there is a specific constraint
6060
regarding custom rules names: they must match the pattern
6161
<code class="docutils literal notranslate"><span class="pre">/^[A-Z][a-zA-Z0-9]*\/[a-z][a-z0-9_]*$/</span></code>.</p>
@@ -78,9 +78,9 @@ <h1>Creating custom rules<a class="headerlink" href="#creating-custom-rules" tit
7878
</div>
7979
<p>There are several interfaces that your fixers can also implement if needed:</p>
8080
<ul class="simple">
81-
<li><p><a class="reference external" href="https://github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/v3.67.0/src/Fixer/WhitespacesAwareFixerInterface.php">PhpCsFixer\Fixer\WhitespacesAwareFixerInterface</a>: for fixers that need to know the configured indentation and line endings;</p></li>
82-
<li><p><a class="reference external" href="https://github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/v3.67.0/src/Fixer/ConfigurableFixerInterface.php">PhpCsFixer\Fixer\ConfigurableFixerInterface</a>: to create a configurable fixer;</p></li>
83-
<li><p><a class="reference external" href="https://github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/v3.67.0/src/Fixer/DeprecatedFixerInterface.php">PhpCsFixer\Fixer\DeprecatedFixerInterface</a>: to deprecate a fixer.</p></li>
81+
<li><p><a class="reference external" href="https://github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/v3.67.1/src/Fixer/WhitespacesAwareFixerInterface.php">PhpCsFixer\Fixer\WhitespacesAwareFixerInterface</a>: for fixers that need to know the configured indentation and line endings;</p></li>
82+
<li><p><a class="reference external" href="https://github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/v3.67.1/src/Fixer/ConfigurableFixerInterface.php">PhpCsFixer\Fixer\ConfigurableFixerInterface</a>: to create a configurable fixer;</p></li>
83+
<li><p><a class="reference external" href="https://github.com/PHP-CS-Fixer/PHP-CS-Fixer/blob/v3.67.1/src/Fixer/DeprecatedFixerInterface.php">PhpCsFixer\Fixer\DeprecatedFixerInterface</a>: to deprecate a fixer.</p></li>
8484
</ul>
8585
</section>
8686

doc/installation.html

Lines changed: 75 additions & 69 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@
2727
<div class="clearfix">
2828
<div class="logo_header"><a href="/">PHP Coding Standards Fixer</a></div>
2929
<h1 class="title_header">
30-
<strong>Persian Successor (v3.67.0)</strong> edition
30+
<strong>Persian Successor (v3.67.1)</strong> edition
3131
</h1>
3232
</div>
3333
</div>
@@ -52,65 +52,61 @@ <h1 class="title_header">
5252

5353
<section id="installation">
5454
<h1>Installation<a class="headerlink" href="#installation" title="Permalink to this heading"></a></h1>
55-
<section id="requirements">
56-
<h2>Requirements<a class="headerlink" href="#requirements" title="Permalink to this heading"></a></h2>
55+
<p>When developing on multiple projects or with team of developers, it is highly recommended to install PHP CS Fixer as direct dependency per project and not globally on your machine.
56+
This will ensure each team member is using version of the tool expected by given project.</p>
5757
<p>PHP needs to be a minimum version of PHP 7.4.</p>
58-
</section>
59-
<section id="id1">
60-
<h2>Installation<a class="headerlink" href="#id1" title="Permalink to this heading"></a></h2>
61-
<section id="locally">
62-
<h3>Locally<a class="headerlink" href="#locally" title="Permalink to this heading"></a></h3>
63-
<p>Download the <a class="reference external" href="https://cs.symfony.com/download/php-cs-fixer-v3.phar">php-cs-fixer.phar</a> file and store it somewhere on your computer.</p>
64-
</section>
65-
<section id="globally-manual">
66-
<h3>Globally (manual)<a class="headerlink" href="#globally-manual" title="Permalink to this heading"></a></h3>
67-
<p>You can run these commands to easily access latest <code class="docutils literal notranslate"><span class="pre">php-cs-fixer</span></code> from anywhere on
68-
your system:</p>
69-
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">wget https://cs.symfony.com/download/php-cs-fixer-v3.phar -O php-cs-fixer</span>
70-
</pre></div>
71-
</div>
72-
<p>or with specified version:</p>
73-
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">wget https://github.com/PHP-CS-Fixer/PHP-CS-Fixer/releases/download/v3.13.0/php-cs-fixer.phar -O php-cs-fixer</span>
74-
</pre></div>
75-
</div>
76-
<p>or with curl:</p>
77-
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">curl -L https://cs.symfony.com/download/php-cs-fixer-v3.phar -o php-cs-fixer</span>
58+
<section id="composer">
59+
<h2>Composer<a class="headerlink" href="#composer" title="Permalink to this heading"></a></h2>
60+
<section id="fresh-installation">
61+
<h3>Fresh installation<a class="headerlink" href="#fresh-installation" title="Permalink to this heading"></a></h3>
62+
<p>To install PHP CS Fixer, <a class="reference external" href="https://getcomposer.org/download/">install Composer</a> and issue the following command:</p>
63+
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">composer require --dev friendsofphp/php-cs-fixer</span>
64+
<span class="gp">#</span><span class="c1"># or when facing conflicts in dependencies:</span>
65+
<span class="go">composer require --dev php-cs-fixer/shim</span>
7866
</pre></div>
7967
</div>
80-
<p>then:</p>
81-
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">sudo chmod a+x php-cs-fixer</span>
82-
<span class="go">sudo mv php-cs-fixer /usr/local/bin/php-cs-fixer</span>
68+
</section>
69+
<section id="upgrade">
70+
<h3>Upgrade<a class="headerlink" href="#upgrade" title="Permalink to this heading"></a></h3>
71+
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">composer upgrade friendsofphp/php-cs-fixer</span>
72+
<span class="gp">#</span><span class="c1"># or</span>
73+
<span class="go">composer upgrade php-cs-fixer/shim</span>
8374
</pre></div>
8475
</div>
85-
<p>Then, just run <code class="docutils literal notranslate"><span class="pre">php-cs-fixer</span></code>.</p>
8676
</section>
87-
<section id="globally-composer">
88-
<h3>Globally (Composer)<a class="headerlink" href="#globally-composer" title="Permalink to this heading"></a></h3>
89-
<p>To install PHP CS Fixer, <a class="reference external" href="https://getcomposer.org/download/">install Composer</a> and issue the following command:</p>
90-
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">composer global require friendsofphp/php-cs-fixer</span>
77+
</section>
78+
<section id="docker">
79+
<h2>Docker<a class="headerlink" href="#docker" title="Permalink to this heading"></a></h2>
80+
<p>You can use pre-built Docker images to run <code class="docutils literal notranslate"><span class="pre">php-cs-fixer</span></code>.</p>
81+
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">docker run -it --rm -v $(pwd):/code ghcr.io/php-cs-fixer/php-cs-fixer:${FIXER_VERSION:-3-php8.3} fix src</span>
9182
</pre></div>
9283
</div>
93-
<p>Then make sure you have the global Composer binaries directory in your <code class="docutils literal notranslate"><span class="pre">PATH</span></code>. This directory is platform-dependent, see <a class="reference external" href="https://getcomposer.org/doc/03-cli.md#composer-home">Composer documentation</a> for details. Example for some Unix systems:</p>
94-
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">export PATH=&quot;$PATH:$HOME/.composer/vendor/bin&quot;</span>
84+
<p><code class="docutils literal notranslate"><span class="pre">$FIXER_VERSION</span></code> used in example above is an identifier of a release you want to use, which is based on Fixer and PHP versions combined. There are different tags for each Fixer’s SemVer level and PHP version with syntax <code class="docutils literal notranslate"><span class="pre">&lt;php-cs-fixer-version&gt;-php&lt;php-version&gt;</span></code>. For example:</p>
85+
<ul class="simple">
86+
<li><p><code class="docutils literal notranslate"><span class="pre">3.66.1-php7.4</span></code></p></li>
87+
<li><p><code class="docutils literal notranslate"><span class="pre">3.66-php8.0</span></code></p></li>
88+
<li><p><code class="docutils literal notranslate"><span class="pre">3-php8.3</span></code></p></li>
89+
</ul>
90+
</section>
91+
<section id="phive">
92+
<h2>PHIVE<a class="headerlink" href="#phive" title="Permalink to this heading"></a></h2>
93+
<section id="id1">
94+
<h3>Fresh installation<a class="headerlink" href="#id1" title="Permalink to this heading"></a></h3>
95+
<p>Install <a class="reference external" href="https://phar.io">PHIVE</a> and issue the following command:</p>
96+
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">phive install php-cs-fixer</span>
9597
</pre></div>
9698
</div>
9799
</section>
98-
<section id="globally-homebrew">
99-
<h3>Globally (homebrew)<a class="headerlink" href="#globally-homebrew" title="Permalink to this heading"></a></h3>
100-
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">brew install php-cs-fixer</span>
100+
<section id="id3">
101+
<h3>Upgrade<a class="headerlink" href="#id3" title="Permalink to this heading"></a></h3>
102+
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">phive update php-cs-fixer</span>
101103
</pre></div>
102104
</div>
103105
</section>
104-
<section id="locally-phive">
105-
<h3>Locally (PHIVE)<a class="headerlink" href="#locally-phive" title="Permalink to this heading"></a></h3>
106-
<p>Install <a class="reference external" href="https://phar.io">PHIVE</a> and issue the following command:</p>
107-
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">phive install php-cs-fixer # use `--global` for global install</span>
108-
</pre></div>
109-
</div>
110106
</section>
111107
<section id="github-action-docker">
112-
<h3>GitHub Action (Docker)<a class="headerlink" href="#github-action-docker" title="Permalink to this heading"></a></h3>
113-
<p>To integrate php-cs-fixer as check into a GitHub Action step, you can use a configuration like this:</p>
108+
<h2>GitHub Action (Docker)<a class="headerlink" href="#github-action-docker" title="Permalink to this heading"></a></h2>
109+
<p>To integrate PHP CS Fixer as check into a GitHub Action step, you can use a configuration like this:</p>
114110
<div class="highlight-yaml notranslate"><div class="highlight"><pre><span></span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">PHP-CS-Fixer</span>
115111
<span class="w"> </span><span class="nt">uses</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">docker://ghcr.io/php-cs-fixer/php-cs-fixer:3-php8.3</span>
116112
<span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">with</span><span class="p p-Indicator">:</span>
@@ -120,8 +116,8 @@ <h3>GitHub Action (Docker)<a class="headerlink" href="#github-action-docker" tit
120116
</div>
121117
</section>
122118
<section id="gitlab-ci-docker">
123-
<h3>Gitlab-CI (Docker)<a class="headerlink" href="#gitlab-ci-docker" title="Permalink to this heading"></a></h3>
124-
<p>To integrate php-cs-fixer as check into Gitlab-CI, you can use a configuration like this:</p>
119+
<h2>Gitlab-CI (Docker)<a class="headerlink" href="#gitlab-ci-docker" title="Permalink to this heading"></a></h2>
120+
<p>To integrate PHP CS Fixer as check into Gitlab-CI, you can use a configuration like this:</p>
125121
<div class="highlight-yaml notranslate"><div class="highlight"><pre><span></span><span class="nt">php-cs-fixer</span><span class="p">:</span>
126122
<span class="w"> </span><span class="nt">image</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ghcr.io/php-cs-fixer/php-cs-fixer:${FIXER_VERSION:-3-php8.3}</span>
127123
<span class="w"> </span><span class="nt">script</span><span class="p">:</span>
@@ -130,40 +126,50 @@ <h3>Gitlab-CI (Docker)<a class="headerlink" href="#gitlab-ci-docker" title="Perm
130126
</pre></div>
131127
</div>
132128
</section>
133-
</section>
134-
<section id="update">
135-
<h2>Update<a class="headerlink" href="#update" title="Permalink to this heading"></a></h2>
136-
<section id="id2">
137-
<h3>Locally<a class="headerlink" href="#id2" title="Permalink to this heading"></a></h3>
138-
<p>The <code class="docutils literal notranslate"><span class="pre">self-update</span></code> command tries to update <code class="docutils literal notranslate"><span class="pre">php-cs-fixer</span></code> itself:</p>
139-
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">php php-cs-fixer.phar self-update</span>
129+
<section id="homebrew-globally">
130+
<h2>Homebrew (globally)<a class="headerlink" href="#homebrew-globally" title="Permalink to this heading"></a></h2>
131+
<p>While not recommended to install the tool globally, it is possible to use homebrew as well.</p>
132+
<section id="id4">
133+
<h3>Fresh installation<a class="headerlink" href="#id4" title="Permalink to this heading"></a></h3>
134+
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">brew install php-cs-fixer</span>
140135
</pre></div>
141136
</div>
142137
</section>
143-
<section id="id3">
144-
<h3>Globally (manual)<a class="headerlink" href="#id3" title="Permalink to this heading"></a></h3>
145-
<p>You can update <code class="docutils literal notranslate"><span class="pre">php-cs-fixer</span></code> through this command:</p>
146-
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">sudo php-cs-fixer self-update</span>
138+
<section id="id5">
139+
<h3>Upgrade<a class="headerlink" href="#id5" title="Permalink to this heading"></a></h3>
140+
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">brew upgrade php-cs-fixer</span>
147141
</pre></div>
148142
</div>
149143
</section>
150-
<section id="id4">
151-
<h3>Globally (Composer)<a class="headerlink" href="#id4" title="Permalink to this heading"></a></h3>
152-
<p>You can update <code class="docutils literal notranslate"><span class="pre">php-cs-fixer</span></code> through this command:</p>
153-
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">./composer.phar global update friendsofphp/php-cs-fixer</span>
144+
</section>
145+
<section id="manual-binary-download">
146+
<h2>Manual binary download<a class="headerlink" href="#manual-binary-download" title="Permalink to this heading"></a></h2>
147+
<p>It is also possible to download the <a class="reference external" href="https://cs.symfony.com/download/php-cs-fixer-v3.phar">php-cs-fixer.phar</a> file and store it somewhere on your computer.</p>
148+
<section id="id6">
149+
<h3>Fresh installation<a class="headerlink" href="#id6" title="Permalink to this heading"></a></h3>
150+
<p>To do that, you can run these commands to easily access latest <code class="docutils literal notranslate"><span class="pre">php-cs-fixer</span></code> from anywhere on
151+
your system:</p>
152+
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">wget https://cs.symfony.com/download/php-cs-fixer-v3.phar -O php-cs-fixer</span>
153+
<span class="gp"># </span>or
154+
<span class="go">curl -L https://cs.symfony.com/download/php-cs-fixer-v3.phar -o php-cs-fixer</span>
154155
</pre></div>
155156
</div>
156-
</section>
157-
<section id="id5">
158-
<h3>Globally (homebrew)<a class="headerlink" href="#id5" title="Permalink to this heading"></a></h3>
159-
<p>You can update <code class="docutils literal notranslate"><span class="pre">php-cs-fixer</span></code> through this command:</p>
160-
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">brew upgrade php-cs-fixer</span>
157+
<p>or with specified version:</p>
158+
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">wget https://github.com/PHP-CS-Fixer/PHP-CS-Fixer/releases/download/v3.66.0/php-cs-fixer.phar -O php-cs-fixer</span>
159+
<span class="gp"># </span>or
160+
<span class="go">curl -L https://github.com/PHP-CS-Fixer/PHP-CS-Fixer/releases/download/v3.66.0/php-cs-fixer.phar -o php-cs-fixer</span>
161+
</pre></div>
162+
</div>
163+
<p>then:</p>
164+
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">sudo chmod a+x php-cs-fixer</span>
165+
<span class="go">sudo mv php-cs-fixer /usr/local/bin/php-cs-fixer</span>
161166
</pre></div>
162167
</div>
168+
<p>Then, just run <code class="docutils literal notranslate"><span class="pre">php-cs-fixer</span></code>.</p>
163169
</section>
164-
<section id="id6">
165-
<h3>Locally (PHIVE)<a class="headerlink" href="#id6" title="Permalink to this heading"></a></h3>
166-
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">phive update php-cs-fixer</span>
170+
<section id="id7">
171+
<h3>Upgrade<a class="headerlink" href="#id7" title="Permalink to this heading"></a></h3>
172+
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">sudo php-cs-fixer self-update</span>
167173
</pre></div>
168174
</div>
169175
</section>

0 commit comments

Comments
 (0)