static-php-cli/assets/en_contributing_index.md.CsY8mx8F.js

import{_ as e,c as t,o,a1 as i}from"./chunks/framework.gjrnbxUT.js";const f=JSON.parse('{"title":"Contributing","description":"","frontmatter":{},"headers":[],"relativePath":"en/contributing/index.md","filePath":"en/contributing/index.md"}'),n={name:"en/contributing/index.md"},a=i('<h1 id="contributing" tabindex="-1">Contributing <a class="header-anchor" href="#contributing" aria-label="Permalink to &quot;Contributing&quot;">​</a></h1><p>Thank you for being here, this project welcomes your contributions!</p><h2 id="contribution-guide" tabindex="-1">Contribution Guide <a class="header-anchor" href="#contribution-guide" aria-label="Permalink to &quot;Contribution Guide&quot;">​</a></h2><p>If you have code or documentation to contribute, here&#39;s what you need to know first.</p><ol><li>What type of code are you contributing? (new extensions, bug fixes, security issues, project framework optimizations, documentation)</li><li>If you contribute new files or new snippets, is your code checked by <code>php-cs-fixer</code> and <code>phpstan</code>?</li><li>Have you fully read the <a href="./../develop/">Developer Guide</a> before contributing code?</li></ol><p>If you can answer the above questions and have made changes to the code, you can initiate a Pull Request in the project GitHub repository in time. After the code review is completed, the code can be modified according to the suggestion, or directly merged into the main branch.</p><h2 id="contribution-type" tabindex="-1">Contribution Type <a class="header-anchor" href="#contribution-type" aria-label="Permalink to &quot;Contribution Type&quot;">​</a></h2><p>The main purpose of this project is to compile statically linked PHP binaries, and the command line processing function is written based on <code>symfony/console</code>. Before development, if you are not familiar with it, Check out the <a href="https://symfony.com/doc/current/components/console.html" target="_blank" rel="noreferrer">symfony/console documentation</a> first.</p><h3 id="security-update" tabindex="-1">Security Update <a class="header-anchor" href="#security-update" aria-label="Permalink to &quot;Security Update&quot;">​</a></h3><p>Because this project is basically a PHP project running locally, generally speaking, there will be no remote attacks. But if you find such a problem, please **DO NOT submit a PR or Issue in the GitHub repository, You need to contact the project maintainer (crazywhalecc) via <a href="mailto:admin@zhamao.me" target="_blank" rel="noreferrer">mail</a>.</p><h3 id="fix-bugs" tabindex="-1">Fix Bugs <a class="header-anchor" href="#fix-bugs" aria-label="Permalink to &quot;Fix Bugs&quot;">​</a></h3><p>Fixing bugs generally does not involve modification of the project structure and framework, so if you can locate the wrong code and fix it directly, please submit a PR directly.</p><h3 id="new-extensions" tabindex="-1">New Extensions <a class="header-anchor" href="#new-extensions" aria-label="Permalink to &quot;New Extensions&quot;">​</a></h3><p>For adding a new extension, you need to understand some basic structure of the project and how to add a new extension according to the existing logic. It will be covered in detail in the next section on this page. In general, you will need:</p><ol><li>Evaluate whether the extension can be compiled inline into PHP.</li><li>Evaluate whether the extension&#39;s dependent libraries (if any) can be compiled statically.</li><li>Write library compile commands on different platforms.</li><li>Verify that the extension and its dependencies are compatible with existing extensions and dependencies.</li><li>Verify that the extension works normally in <code>cli</code>, <code>micro</code>, <code>fpm</code>, <code>embed</code> SAPIs.</li><li>Write documentation and add your extension.</li></ol><h3 id="project-framework-optimization" tabindex="-1">Project Framework Optimization <a class="header-anchor" href="#project-framework-optimization" aria-label="Permalink to &quot;Project Framework Optimization&quot;">​</a></h3><p>If you are already familiar with