Deployed 5221789 with MkDocs

Author: github-actions

7.2/assets/images/application-datacollector.graphviz.svg

@@ -268,7 +268,7 @@ digraph {
     <tr><td bgcolor="#eeeeee"><b><br/>NodeNormalizer</b></td></tr>
     <tr><td></td></tr>
     <tr><td><table border="0" cellspacing="0" cellpadding="2">
-    <tr><td align="left">+ normalize(object, format = «unknown», context : array = [])</td></tr>
+    <tr><td align="left">+ normalize(object, format = «unknown», context : array = []) : ?array</td></tr>
     <tr><td align="left">+ supportsNormalization(data : mixed, format : string = «unknown») : bool</td></tr>
     <tr><td align="left">+ getSupportedTypes(format : string) : array</td></tr>
 </table></td></tr>

7.2/assets/images/application-datacollector.html.gv

@@ -633,7 +633,7 @@ <h1 id="hooks">Hooks</h1>
 <p><code>AfterProcessSniffInterface</code> - called after leaving a sniff.</p>
 </li>
 </ul>
-<p>Furthermore extensions may implement the <code>Symfony\Component\EventDispatcher\EventSubscriberInterface</code>.</p>
+<p>Furthermore, extensions may implement the <code>Symfony\Component\EventDispatcher\EventSubscriberInterface</code>.</p>
 <p>See built-in extensions <code>Application\Extension\Logger</code> and <code>Application\Extension\ProgressBar</code> as examples.</p>
 
 

7.2/components/extensions/index.html

@@ -666,6 +666,24 @@
     </span>
   </a>
 
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#php-83" class="md-nav__link">
+    <span class="md-ellipsis">
+      PHP 8.3
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#php-84" class="md-nav__link">
+    <span class="md-ellipsis">
+      PHP 8.4
+    </span>
+  </a>
+  
 </li>
 
     </ul>
@@ -866,6 +884,38 @@ <h2 id="php-82"><a href="https://github.com/symfony/polyfill-php82">PHP 8.2</a><
 </tbody>
 </table>
 <p>Available since release 6.5.0</p>
+<h2 id="php-83"><a href="https://github.com/symfony/polyfill-php83">PHP 8.3</a></h2>
+<table>
+<thead>
+<tr>
+<th>Polyfill class name</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code>SymfonyPhp83</code></td>
+<td>This polyfill detects features unavailable in releases prior to PHP 8.3</td>
+</tr>
+</tbody>
+</table>
+<p>Available since release 7.2.0</p>
+<h2 id="php-84"><a href="https://github.com/symfony/polyfill-php84">PHP 8.4</a></h2>
+<table>
+<thead>
+<tr>
+<th>Polyfill class name</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code>SymfonyPhp84</code></td>
+<td>This polyfill detects features unavailable in releases prior to PHP 8.4</td>
+</tr>
+</tbody>
+</table>
+<p>Available since release 7.2.0</p>
 
 
 

7.2/components/polyfills/index.html

@@ -579,34 +579,36 @@
 
 <!-- markdownlint-disable MD013 -->
 <h1 id="limitation">Limitation</h1>
-<div class="highlight"><pre><span></span><code><span class="x">// @link https://github.com/nikic/PHP-Parser/blob/v4.10.0/lib/PhpParser/Lexer.php#L413-L433</span>
-
-<span class="x">$compatTokens = [</span>
-<span class="x">    // PHP 7.4</span>
-<span class="x">    &#39;T_BAD_CHARACTER&#39;,</span>
-<span class="x">    &#39;T_FN&#39;,</span>
-<span class="x">    &#39;T_COALESCE_EQUAL&#39;,</span>
-<span class="x">    // PHP 8.0</span>
-<span class="x">    &#39;T_NAME_QUALIFIED&#39;,</span>
-<span class="x">    &#39;T_NAME_FULLY_QUALIFIED&#39;,</span>
-<span class="x">    &#39;T_NAME_RELATIVE&#39;,</span>
-<span class="x">    &#39;T_MATCH&#39;,</span>
-<span class="x">    &#39;T_NULLSAFE_OBJECT_OPERATOR&#39;,</span>
-<span class="x">    &#39;T_ATTRIBUTE&#39;,</span>
-<span class="x">];</span>
-
-<span class="x">foreach ($compatTokens as $token) {</span>
-<span class="x">    if (\defined($token)) {</span>
-<span class="x">        $tokenId = \constant($token);</span>
-<span class="x">    }</span>
-<span class="x">}</span>
+<div class="highlight"><pre><span></span><code><span class="cp">&lt;?php</span>
+<span class="c1">// @link https://github.com/nikic/PHP-Parser/blob/v4.10.0/lib/PhpParser/Lexer.php#L413-L433</span>
+
+<span class="nv">$compatTokens</span> <span class="o">=</span> <span class="p">[</span>
+    <span class="c1">// PHP 7.4</span>
+    <span class="s1">&#39;T_BAD_CHARACTER&#39;</span><span class="p">,</span>
+    <span class="s1">&#39;T_FN&#39;</span><span class="p">,</span>
+    <span class="s1">&#39;T_COALESCE_EQUAL&#39;</span><span class="p">,</span>
+    <span class="c1">// PHP 8.0</span>
+    <span class="s1">&#39;T_NAME_QUALIFIED&#39;</span><span class="p">,</span>
+    <span class="s1">&#39;T_NAME_FULLY_QUALIFIED&#39;</span><span class="p">,</span>
+    <span class="s1">&#39;T_NAME_RELATIVE&#39;</span><span class="p">,</span>
+    <span class="s1">&#39;T_MATCH&#39;</span><span class="p">,</span>
+    <span class="s1">&#39;T_NULLSAFE_OBJECT_OPERATOR&#39;</span><span class="p">,</span>
+    <span class="s1">&#39;T_ATTRIBUTE&#39;</span><span class="p">,</span>
+<span class="p">];</span>
+
+<span class="k">foreach</span> <span class="p">(</span><span class="nv">$compatTokens</span> <span class="k">as</span> <span class="nv">$token</span><span class="p">)</span> <span class="p">{</span>
+    <span class="k">if</span> <span class="p">(</span><span class="nx">\defined</span><span class="p">(</span><span class="nv">$token</span><span class="p">))</span> <span class="p">{</span>
+        <span class="nv">$tokenId</span> <span class="o">=</span> <span class="nx">\constant</span><span class="p">(</span><span class="nv">$token</span><span class="p">);</span>
+    <span class="p">}</span>
+<span class="p">}</span>
 </code></pre></div>
 <p>Here we cannot detect that constants listed in <code>$compatTokens</code> array are perhaps condition code.</p>
 <p>Later, in another script or even the same one, if we used these constants we will detect them as PHP 7.4 or PHP 8.0 versions,
 but it's not the reality.</p>
 <p>Example with</p>
-<div class="highlight"><pre><span></span><code><span class="x">// @link https://github.com/nikic/PHP-Parser/blob/v4.10.0/lib/PhpParser/Lexer.php#L110</span>
-<span class="x">$tokens[] = [\T_BAD_CHARACTER, $chr, $line];</span>
+<div class="highlight"><pre><span></span><code><span class="cp">&lt;?php</span>
+<span class="c1">// @link https://github.com/nikic/PHP-Parser/blob/v4.10.0/lib/PhpParser/Lexer.php#L110</span>
+<span class="nv">$tokens</span><span class="p">[]</span> <span class="o">=</span> <span class="p">[</span><span class="nx">\T_BAD_CHARACTER</span><span class="p">,</span> <span class="nv">$chr</span><span class="p">,</span> <span class="nv">$line</span><span class="p">];</span>
 </code></pre></div>
 <p>Console output tell us</p>
 <div class="highlight"><pre><span></span><code>Constants Analysis

7.2/conditional-code/limitation/index.html

@@ -580,13 +580,15 @@
 <!-- markdownlint-disable MD013 -->
 <h1 id="multiple-signatures">Multiple signatures</h1>
 <p>Face to this source code, CompatInfo is unable to know what <code>idn_to_ascii</code> signature is the minimum.</p>
-<div class="highlight"><pre><span></span><code><span class="x">if (function_exists(&#39;idn_to_ascii&#39;)) {</span>
-<span class="x">    if (defined(&#39;INTL_IDNA_VARIANT_UTS46&#39;)) {</span>
-<span class="x">        $domain = idn_to_ascii($domain, 0, INTL_IDNA_VARIANT_UTS46);</span>
-<span class="x">    } else {</span>
-<span class="x">        $domain = idn_to_ascii($domain);</span>
-<span class="x">    }</span>
-<span class="x">}</span>
+<div class="highlight"><pre><span></span><code><span class="cp">&lt;?php</span>
+
+<span class="k">if</span> <span class="p">(</span><span class="nb">function_exists</span><span class="p">(</span><span class="s1">&#39;idn_to_ascii&#39;</span><span class="p">))</span> <span class="p">{</span>
+    <span class="k">if</span> <span class="p">(</span><span class="nb">defined</span><span class="p">(</span><span class="s1">&#39;INTL_IDNA_VARIANT_UTS46&#39;</span><span class="p">))</span> <span class="p">{</span>
+        <span class="nv">$domain</span> <span class="o">=</span> <span class="nb">idn_to_ascii</span><span class="p">(</span><span class="nv">$domain</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="nx">INTL_IDNA_VARIANT_UTS46</span><span class="p">);</span>
+    <span class="p">}</span> <span class="k">else</span> <span class="p">{</span>
+        <span class="nv">$domain</span> <span class="o">=</span> <span class="nb">idn_to_ascii</span><span class="p">(</span><span class="nv">$domain</span><span class="p">);</span>
+    <span class="p">}</span>
+<span class="p">}</span>
 </code></pre></div>
 <p>We know (<a href="https://www.php.net/manual/en/function.idn-to-ascii.php#refsect1-function.idn-to-ascii-changelog">idn_to_ascii changelog</a>)
 that by using <code>$variant</code> parameter, the minimum PHP version required is <strong>7.4.0</strong>, otherwise it's only <strong>5.2.4</strong></p>

7.2/conditional-code/multiple-signature/index.html

@@ -677,7 +677,7 @@ <h2 id="with-console-cli">With Console (CLI)</h2>
 <div class="highlight"><pre><span></span><code>bin/phpcompatinfo<span class="w"> </span>analyser:run<span class="w"> </span>.<span class="w"> </span>--exclude<span class="w"> </span>vendor<span class="w"> </span>--exclude<span class="w"> </span>tests
 </code></pre></div>
 <h2 id="with-php-script-api">With php script (API)</h2>
-<div class="highlight"><pre><span></span><code><span class="x">require_once &#39;config/bootstrap.php&#39;;</span>
+<div class="highlight"><pre><span></span><code><span class="x">require_once &#39;autoload.php&#39;;</span>
 
 <span class="x">use Bartlett\CompatInfo\Application\Profiler\Profile;</span>
 <span class="x">use Bartlett\CompatInfo\Application\Query\Analyser\Compatibility\GetCompatibilityQuery;</span>

7.2/exclusions/index.html

@@ -761,11 +761,11 @@
 <h1 id="about">About</h1>
 <p><strong>PHP CompatInfo</strong> is a library that
 can find the minimum version and the extensions required for a piece of code to run.</p>
-<p>Running on PHP greater or equal than 8.0 for parsing source code in a format PHP 5.2 to PHP 8.3</p>
+<p>Running on PHP greater or equal than 8.0 for parsing source code in a format PHP 5.2 to PHP 8.4</p>
 <p><img alt="Graph Composer" src="assets/images/graph-composer.svg" /></p>
 <h2 id="features">Features</h2>
 <ul>
-<li>Parse source code in format PHP 5.2 to PHP 8.3</li>
+<li>Parse source code in format PHP 5.2 to PHP 8.4</li>
 <li>Detect PHP features for each Major/minor versions</li>
 <li>Detect versions of all directives, constants, functions, classes, interfaces of 100 extensions and more</li>
 <li>Display/Inspect list of extensions, and their versions supported</li>

7.2/index.html

@@ -772,12 +772,12 @@ <h1 id="installation">Installation</h1>
 </ol>
 <h2 id="requirements">Requirements</h2>
 <ul>
-<li>PHP 8.0 or greater</li>
+<li>PHP 8.1 or greater</li>
 <li>ext-json</li>
 <li>ext-pcre (required by: bartlett/php-compatinfo-db)</li>
 <li>ext-pdo (required by: bartlett/php-compatinfo-db)</li>
 <li>ext-spl</li>
-<li>PHPUnit 9 or greater (if you want to run unit tests)</li>
+<li>PHPUnit 10.5 or greater (if you want to run unit tests)</li>
 </ul>
 <h2 id="phar">PHAR</h2>
 <p>The preferred method of installation is to use the CompatInfo PHAR version which can be downloaded from the most recent
@@ -798,15 +798,15 @@ <h2 id="phive">Phive</h2>
 <p>You can also install application locally to your project with <a href="https://github.com/phar-io/phive">Phive</a> and configuration file <code>.phive/phars.xml</code></p>
 <div class="highlight"><pre><span></span><code><span class="cp">&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;</span>
 <span class="nt">&lt;phive</span><span class="w"> </span><span class="na">xmlns=</span><span class="s">&quot;https://phar.io/phive&quot;</span><span class="nt">&gt;</span>
-<span class="w">    </span><span class="nt">&lt;phar</span><span class="w"> </span><span class="na">name=</span><span class="s">&quot;llaville/php-compatinfo&quot;</span><span class="w"> </span><span class="na">version=</span><span class="s">&quot;^7.1&quot;</span><span class="w"> </span><span class="na">copy=</span><span class="s">&quot;false&quot;</span><span class="w"> </span><span class="nt">/&gt;</span>
+<span class="w">    </span><span class="nt">&lt;phar</span><span class="w"> </span><span class="na">name=</span><span class="s">&quot;llaville/php-compatinfo&quot;</span><span class="w"> </span><span class="na">version=</span><span class="s">&quot;^7.2&quot;</span><span class="w"> </span><span class="na">copy=</span><span class="s">&quot;false&quot;</span><span class="w"> </span><span class="nt">/&gt;</span>
 <span class="nt">&lt;/phive&gt;</span>
 </code></pre></div>
 <div class="highlight"><pre><span></span><code>phive<span class="w"> </span>install<span class="w"> </span>--force-accept-unsigned
 </code></pre></div>
 <h2 id="composer">Composer</h2>
 <p>The recommended way to install this library is <a href="https://getcomposer.org">through composer</a>.
 If you don't know yet what is composer, have a look <a href="http://getcomposer.org/doc/00-intro.md">on introduction</a>.</p>
-<div class="highlight"><pre><span></span><code>composer<span class="w"> </span>require<span class="w"> </span>bartlett/php-compatinfo<span class="w"> </span>^7.1
+<div class="highlight"><pre><span></span><code>composer<span class="w"> </span>require<span class="w"> </span>bartlett/php-compatinfo<span class="w"> </span>^7.2
 </code></pre></div>
 <p>If you cannot install it because of a dependency conflict, or you prefer to install it for your project, we recommend
 you to take a look at <a href="https://github.com/bamarni/composer-bin-plugin">bamarni/composer-bin-plugin</a>. Example:</p>
@@ -817,7 +817,7 @@ <h2 id="composer">Composer</h2>
 </code></pre></div>
 <h2 id="git">Git</h2>
 <p>The PHP CompatInfo can be directly used from <a href="https://github.com/llaville/php-compatinfo.git">GitHub</a> by cloning the repository into a directory of your choice.</p>
-<div class="highlight"><pre><span></span><code>git<span class="w"> </span>clone<span class="w"> </span>-b<span class="w"> </span><span class="m">7</span>.1<span class="w"> </span>https://github.com/llaville/php-compatinfo.git
+<div class="highlight"><pre><span></span><code>git<span class="w"> </span>clone<span class="w"> </span>-b<span class="w"> </span><span class="m">7</span>.2<span class="w"> </span>https://github.com/llaville/php-compatinfo.git
 </code></pre></div>
 <h2 id="configuring-the-database">Configuring the Database</h2>
 <p>The database connection information is stored as an environment variable called <code>DATABASE_URL</code>.</p>
@@ -833,10 +833,9 @@ <h2 id="configuring-the-database">Configuring the Database</h2>
 <span class="c1"># to use postgresql:</span>
 <span class="nv">DATABASE_URL</span><span class="o">=</span><span class="s2">&quot;postgresql://db_user:db_password@127.0.0.1:5432/db_name?serverVersion=11&amp;charset=utf8&quot;</span>
 </code></pre></div>
-<p>After installation, or if you change database connection, you have to run following command(s):</p>
+<p>After installation, or if you change database connection, you have to run following command:</p>
 <ul>
-<li><code>bin/phpcompatinfo db:create</code></li>
-<li><code>bin/phpcompatinfo db:init</code></li>
+<li><code>bin/phpcompatinfo db:new</code></li>
 </ul>
 <p>At first run of CompatInfo, <code>DATABASE_URL</code> will be set to use default SQLite connection</p>