add option --no-motd

添加快速进入编译环境的脚本

.github/workflows/build.yml

@@ -0,0 +1,129 @@
+name: CI
+
+on:
+  workflow_dispatch:
+    inputs:
+      operating-system:
+        required: true
+        description: Compile target OS
+        type: choice
+        options:
+          - ubuntu-latest
+          - macos-latest
+      version:
+        required: true
+        description: php version to compile
+        default: '8.2'
+        type: choice
+        options:
+          - '8.2'
+          - '8.1'
+          - '8.0'
+          - '7.4'
+      build-cli:
+        description: build cli binary
+        default: true
+        type: boolean
+      build-micro:
+        description: build phpmicro binary
+        type: boolean
+      build-fpm:
+        description: build fpm binary
+        type: boolean
+      extensions:
+        description: extensions to compile (comma separated)
+        required: true
+        type: string
+      debug:
+        type: boolean
+
+env:
+  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+jobs:
+  build:
+    name: build ${{ inputs.version }} on ${{ inputs.operating-system }}
+    runs-on: ${{ inputs.operating-system }}
+    steps:
+      - uses: actions/checkout@v3
+
+      # Install macOS missing packages and mark os suffix
+      - if: ${{ inputs.operating-system == 'macos-latest' }}
+        run: |
+          brew install automake gzip
+          echo "SPC_BUILD_OS=macos" >> $GITHUB_ENV
+
+      # Install Ubuntu missing packages and mark os suffix
+      - if: ${{ inputs.operating-system == 'ubuntu-latest' }}
+        run: |
+          sudo apt install musl-tools -y
+          echo "SPC_BUILD_OS=linux" >> $GITHUB_ENV
+
+      # Cache composer dependencies
+      - id: cache-composer-deps
+        uses: actions/cache@v3
+        with:
+          path: vendor
+          key: composer-dependencies
+
+      # If there's no Composer cache, install dependencies
+      - if: steps.cache-composer-deps.outputs.cache-hit != 'true'
+        run: composer update --no-dev
+
+      # Cache downloaded source
+      - id: cache-download
+        uses: actions/cache@v3
+        with:
+          path: downloads
+          key: php-${{ inputs.version }}-dependencies
+
+      # With or without debug
+      - if: inputs.debug == true
+        run: echo "SPC_BUILD_DEBUG=--debug" >> $GITHUB_ENV
+
+      # With target select: cli, micro or both
+      - if: ${{ inputs.build-cli == true }}
+        run: echo "SPC_BUILD_CLI=--build-cli" >> $GITHUB_ENV
+      - if: ${{ inputs.build-micro == true }}
+        run: echo "SPC_BUILD_MICRO=--build-micro" >> $GITHUB_ENV
+      - if: ${{ inputs.build-fpm == true }}
+        run: echo "SPC_BUILD_FPM=--build-fpm" >> $GITHUB_ENV
+
+      # If there's no dependencies cache, fetch sources, with or without debug
+      - run: CACHE_API_EXEC=yes ./bin/spc fetch --with-php=${{ inputs.version }} --all ${{ env.SPC_BUILD_DEBUG }}
+
+      # Run build command
+      - run: ./bin/spc build ${{ inputs.extensions }} ${{ env.SPC_BUILD_DEBUG }} ${{ env.SPC_BUILD_CLI }} ${{ env.SPC_BUILD_MICRO }} ${{ env.SPC_BUILD_FPM }}
+
+      # Upload cli executable
+      - if: ${{ inputs.build-cli == true }}
+        uses: actions/upload-artifact@v3
+        with:
+          name: php-${{ inputs.version }}-${{ env.SPC_BUILD_OS }}
+          path: buildroot/bin/php
+
+      # Upload micro self-extracted executable
+      - if: ${{ inputs.build-micro == true }}
+        uses: actions/upload-artifact@v3
+        with:
+          name: micro-${{ inputs.version }}-${{ env.SPC_BUILD_OS }}
+          path: buildroot/bin/micro.sfx
+
+      # Upload fpm executable
+      - if: ${{ inputs.build-fpm == true }}
+        uses: actions/upload-artifact@v3
+        with:
+          name: php-fpm-${{ inputs.version }}-${{ env.SPC_BUILD_OS }}
+          path: buildroot/bin/php-fpm
+
+      # Upload extensions metadata
+      - uses: actions/upload-artifact@v3
+        with:
+          name: license-files
+          path: buildroot/license/
+      - uses: actions/upload-artifact@v3
+        with:
+          name: build-meta
+          path: |
+            buildroot/build-extensions.json
+            buildroot/build-libraries.json

.gitignore

@@ -0,0 +1,26 @@
+.idea
+runtime/
+docker/libraries/
+docker/extensions/
+docker/source/
+
+# Composer file
+composer.lock
+/vendor/
+
+# default source extract directory
+/source/
+
+# default source download directory
+/downloads/
+
+# default source build root directory
+/buildroot/
+
+# php cs fixer cache file
+.php-cs-fixer.cache
+
+# exclude self-runtime
+/bin/*
+!/bin/spc
+!/bin/setup-runtime

.php-cs-fixer.php

@@ -0,0 +1,69 @@
+<?php
+
+declare(strict_types=1);
+
+return (new PhpCsFixer\Config())
+    ->setRiskyAllowed(true)
+    ->setRules([
+        '@PSR12' => true,
+        '@Symfony' => true,
+        '@PhpCsFixer' => true,
+        'array_syntax' => [
+            'syntax' => 'short',
+        ],
+        'list_syntax' => [
+            'syntax' => 'short',
+        ],
+        'concat_space' => [
+            'spacing' => 'one',
+        ],
+        'blank_line_before_statement' => [
+            'statements' => [
+                'declare',
+            ],
+        ],
+        'ordered_imports' => [
+            'imports_order' => [
+                'class',
+                'function',
+                'const',
+            ],
+            'sort_algorithm' => 'alpha',
+        ],
+        'single_line_comment_style' => [
+            'comment_types' => [
+            ],
+        ],
+        'yoda_style' => [
+            'always_move_variable' => false,
+            'equal' => false,
+            'identical' => false,
+        ],
+        'multiline_whitespace_before_semicolons' => [
+            'strategy' => 'no_multi_line',
+        ],
+        'constant_case' => [
+            'case' => 'lower',
+        ],
+        'class_attributes_separation' => true,
+        'combine_consecutive_unsets' => true,
+        'declare_strict_types' => true,
+        'linebreak_after_opening_tag' => true,
+        'lowercase_static_reference' => true,
+        'no_useless_else' => true,
+        'no_unused_imports' => true,
+        'not_operator_with_successor_space' => false,
+        'not_operator_with_space' => false,
+        'ordered_class_elements' => true,
+        'php_unit_strict' => false,
+        'phpdoc_separation' => false,
+        'single_quote' => true,
+        'standardize_not_equals' => true,
+        'multiline_comment_opening_closing' => true,
+        'phpdoc_summary' => false,
+        'php_unit_test_class_requires_covers' => false,
+        'phpdoc_var_without_name' => false,
+    ])
+    ->setFinder(
+        PhpCsFixer\Finder::create()->in(__DIR__ . '/src')
+    );

LICENSE

@@ -1,674 +1,21 @@
-                    GNU GENERAL PUBLIC LICENSE
-                       Version 3, 29 June 2007
-
- Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
- Everyone is permitted to copy and distribute verbatim copies
- of this license document, but changing it is not allowed.
-
-                            Preamble
-
-  The GNU General Public License is a free, copyleft license for
-software and other kinds of works.
-
-  The licenses for most software and other practical works are designed
-to take away your freedom to share and change the works.  By contrast,
-the GNU General Public License is intended to guarantee your freedom to
-share and change all versions of a program--to make sure it remains free
-software for all its users.  We, the Free Software Foundation, use the
-GNU General Public License for most of our software; it applies also to
-any other work released this way by its authors.  You can apply it to
-your programs, too.
-
-  When we speak of free software, we are referring to freedom, not
-price.  Our General Public Licenses are designed to make sure that you
-have the freedom to distribute copies of free software (and charge for
-them if you wish), that you receive source code or can get it if you
-want it, that you can change the software or use pieces of it in new
-free programs, and that you know you can do these things.
-
-  To protect your rights, we need to prevent others from denying you
-these rights or asking you to surrender the rights.  Therefore, you have
-certain responsibilities if you distribute copies of the software, or if
-you modify it: responsibilities to respect the freedom of others.
-
-  For example, if you distribute copies of such a program, whether
-gratis or for a fee, you must pass on to the recipients the same
-freedoms that you received.  You must make sure that they, too, receive
-or can get the source code.  And you must show them these terms so they
-know their rights.
-
-  Developers that use the GNU GPL protect your rights with two steps:
-(1) assert copyright on the software, and (2) offer you this License
-giving you legal permission to copy, distribute and/or modify it.
-
-  For the developers' and authors' protection, the GPL clearly explains
-that there is no warranty for this free software.  For both users' and
-authors' sake, the GPL requires that modified versions be marked as
-changed, so that their problems will not be attributed erroneously to
-authors of previous versions.
-
-  Some devices are designed to deny users access to install or run
-modified versions of the software inside them, although the manufacturer
-can do so.  This is fundamentally incompatible with the aim of
-protecting users' freedom to change the software.  The systematic
-pattern of such abuse occurs in the area of products for individuals to
-use, which is precisely where it is most unacceptable.  Therefore, we
-have designed this version of the GPL to prohibit the practice for those
-products.  If such problems arise substantially in other domains, we
-stand ready to extend this provision to those domains in future versions
-of the GPL, as needed to protect the freedom of users.
-
-  Finally, every program is threatened constantly by software patents.
-States should not allow patents to restrict development and use of
-software on general-purpose computers, but in those that do, we wish to
-avoid the special danger that patents applied to a free program could
-make it effectively proprietary.  To prevent this, the GPL assures that
-patents cannot be used to render the program non-free.
-
-  The precise terms and conditions for copying, distribution and
-modification follow.
-
-                       TERMS AND CONDITIONS
-
-  0. Definitions.
-
-  "This License" refers to version 3 of the GNU General Public License.
-
-  "Copyright" also means copyright-like laws that apply to other kinds of
-works, such as semiconductor masks.
-
-  "The Program" refers to any copyrightable work licensed under this
-License.  Each licensee is addressed as "you".  "Licensees" and
-"recipients" may be individuals or organizations.
-
-  To "modify" a work means to copy from or adapt all or part of the work
-in a fashion requiring copyright permission, other than the making of an
-exact copy.  The resulting work is called a "modified version" of the
-earlier work or a work "based on" the earlier work.
-
-  A "covered work" means either the unmodified Program or a work based
-on the Program.
-
-  To "propagate" a work means to do anything with it that, without
-permission, would make you directly or secondarily liable for
-infringement under applicable copyright law, except executing it on a
-computer or modifying a private copy.  Propagation includes copying,
-distribution (with or without modification), making available to the
-public, and in some countries other activities as well.
-
-  To "convey" a work means any kind of propagation that enables other
-parties to make or receive copies.  Mere interaction with a user through
-a computer network, with no transfer of a copy, is not conveying.
-
-  An interactive user interface displays "Appropriate Legal Notices"
-to the extent that it includes a convenient and prominently visible
-feature that (1) displays an appropriate copyright notice, and (2)
-tells the user that there is no warranty for the work (except to the
-extent that warranties are provided), that licensees may convey the
-work under this License, and how to view a copy of this License.  If
-the interface presents a list of user commands or options, such as a
-menu, a prominent item in the list meets this criterion.
-
-  1. Source Code.
-
-  The "source code" for a work means the preferred form of the work
-for making modifications to it.  "Object code" means any non-source
-form of a work.
-
-  A "Standard Interface" means an interface that either is an official
-standard defined by a recognized standards body, or, in the case of
-interfaces specified for a particular programming language, one that
-is widely used among developers working in that language.
-
-  The "System Libraries" of an executable work include anything, other
-than the work as a whole, that (a) is included in the normal form of
-packaging a Major Component, but which is not part of that Major
-Component, and (b) serves only to enable use of the work with that
-Major Component, or to implement a Standard Interface for which an
-implementation is available to the public in source code form.  A
-"Major Component", in this context, means a major essential component
-(kernel, window system, and so on) of the specific operating system
-(if any) on which the executable work runs, or a compiler used to
-produce the work, or an object code interpreter used to run it.
-
-  The "Corresponding Source" for a work in object code form means all
-the source code needed to generate, install, and (for an executable
-work) run the object code and to modify the work, including scripts to
-control those activities.  However, it does not include the work's
-System Libraries, or general-purpose tools or generally available free
-programs which are used unmodified in performing those activities but
-which are not part of the work.  For example, Corresponding Source
-includes interface definition files associated with source files for
-the work, and the source code for shared libraries and dynamically
-linked subprograms that the work is specifically designed to require,
-such as by intimate data communication or control flow between those
-subprograms and other parts of the work.
-
-  The Corresponding Source need not include anything that users
-can regenerate automatically from other parts of the Corresponding
-Source.
-
-  The Corresponding Source for a work in source code form is that
-same work.
-
-  2. Basic Permissions.
-
-  All rights granted under this License are granted for the term of
-copyright on the Program, and are irrevocable provided the stated
-conditions are met.  This License explicitly affirms your unlimited
-permission to run the unmodified Program.  The output from running a
-covered work is covered by this License only if the output, given its
-content, constitutes a covered work.  This License acknowledges your
-rights of fair use or other equivalent, as provided by copyright law.
-
-  You may make, run and propagate covered works that you do not
-convey, without conditions so long as your license otherwise remains
-in force.  You may convey covered works to others for the sole purpose
-of having them make modifications exclusively for you, or provide you
-with facilities for running those works, provided that you comply with
-the terms of this License in conveying all material for which you do
-not control copyright.  Those thus making or running the covered works
-for you must do so exclusively on your behalf, under your direction
-and control, on terms that prohibit them from making any copies of
-your copyrighted material outside their relationship with you.
-
-  Conveying under any other circumstances is permitted solely under
-the conditions stated below.  Sublicensing is not allowed; section 10
-makes it unnecessary.
-
-  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
-
-  No covered work shall be deemed part of an effective technological
-measure under any applicable law fulfilling obligations under article
-11 of the WIPO copyright treaty adopted on 20 December 1996, or
-similar laws prohibiting or restricting circumvention of such
-measures.
-
-  When you convey a covered work, you waive any legal power to forbid
-circumvention of technological measures to the extent such circumvention
-is effected by exercising rights under this License with respect to
-the covered work, and you disclaim any intention to limit operation or
-modification of the work as a means of enforcing, against the work's
-users, your or third parties' legal rights to forbid circumvention of
-technological measures.
-
-  4. Conveying Verbatim Copies.
-
-  You may convey verbatim copies of the Program's source code as you
-receive it, in any medium, provided that you conspicuously and
-appropriately publish on each copy an appropriate copyright notice;
-keep intact all notices stating that this License and any
-non-permissive terms added in accord with section 7 apply to the code;
-keep intact all notices of the absence of any warranty; and give all
-recipients a copy of this License along with the Program.
-
-  You may charge any price or no price for each copy that you convey,
-and you may offer support or warranty protection for a fee.
-
-  5. Conveying Modified Source Versions.
-
-  You may convey a work based on the Program, or the modifications to
-produce it from the Program, in the form of source code under the
-terms of section 4, provided that you also meet all of these conditions:
-
-    a) The work must carry prominent notices stating that you modified
-    it, and giving a relevant date.
-
-    b) The work must carry prominent notices stating that it is
-    released under this License and any conditions added under section
-    7.  This requirement modifies the requirement in section 4 to
-    "keep intact all notices".
-
-    c) You must license the entire work, as a whole, under this
-    License to anyone who comes into possession of a copy.  This
-    License will therefore apply, along with any applicable section 7
-    additional terms, to the whole of the work, and all its parts,
-    regardless of how they are packaged.  This License gives no
-    permission to license the work in any other way, but it does not
-    invalidate such permission if you have separately received it.
-
-    d) If the work has interactive user interfaces, each must display
-    Appropriate Legal Notices; however, if the Program has interactive
-    interfaces that do not display Appropriate Legal Notices, your
-    work need not make them do so.
-
-  A compilation of a covered work with other separate and independent
-works, which are not by their nature extensions of the covered work,
-and which are not combined with it such as to form a larger program,
-in or on a volume of a storage or distribution medium, is called an
-"aggregate" if the compilation and its resulting copyright are not
-used to limit the access or legal rights of the compilation's users
-beyond what the individual works permit.  Inclusion of a covered work
-in an aggregate does not cause this License to apply to the other
-parts of the aggregate.
-
-  6. Conveying Non-Source Forms.
-
-  You may convey a covered work in object code form under the terms
-of sections 4 and 5, provided that you also convey the
-machine-readable Corresponding Source under the terms of this License,
-in one of these ways:
-
-    a) Convey the object code in, or embodied in, a physical product
-    (including a physical distribution medium), accompanied by the
-    Corresponding Source fixed on a durable physical medium
-    customarily used for software interchange.
-
-    b) Convey the object code in, or embodied in, a physical product
-    (including a physical distribution medium), accompanied by a
-    written offer, valid for at least three years and valid for as
-    long as you offer spare parts or customer support for that product
-    model, to give anyone who possesses the object code either (1) a
-    copy of the Corresponding Source for all the software in the
-    product that is covered by this License, on a durable physical
-    medium customarily used for software interchange, for a price no
-    more than your reasonable cost of physically performing this
-    conveying of source, or (2) access to copy the
-    Corresponding Source from a network server at no charge.
-
-    c) Convey individual copies of the object code with a copy of the
-    written offer to provide the Corresponding Source.  This
-    alternative is allowed only occasionally and noncommercially, and
-    only if you received the object code with such an offer, in accord
-    with subsection 6b.
-
-    d) Convey the object code by offering access from a designated
-    place (gratis or for a charge), and offer equivalent access to the
-    Corresponding Source in the same way through the same place at no
-    further charge.  You need not require recipients to copy the
-    Corresponding Source along with the object code.  If the place to
-    copy the object code is a network server, the Corresponding Source
-    may be on a different server (operated by you or a third party)
-    that supports equivalent copying facilities, provided you maintain
-    clear directions next to the object code saying where to find the
-    Corresponding Source.  Regardless of what server hosts the
-    Corresponding Source, you remain obligated to ensure that it is
-    available for as long as needed to satisfy these requirements.
-
-    e) Convey the object code using peer-to-peer transmission, provided
-    you inform other peers where the object code and Corresponding
-    Source of the work are being offered to the general public at no
-    charge under subsection 6d.
-
-  A separable portion of the object code, whose source code is excluded
-from the Corresponding Source as a System Library, need not be
-included in conveying the object code work.
-
-  A "User Product" is either (1) a "consumer product", which means any
-tangible personal property which is normally used for personal, family,
-or household purposes, or (2) anything designed or sold for incorporation
-into a dwelling.  In determining whether a product is a consumer product,
-doubtful cases shall be resolved in favor of coverage.  For a particular
-product received by a particular user, "normally used" refers to a
-typical or common use of that class of product, regardless of the status
-of the particular user or of the way in which the particular user
-actually uses, or expects or is expected to use, the product.  A product
-is a consumer product regardless of whether the product has substantial
-commercial, industrial or non-consumer uses, unless such uses represent
-the only significant mode of use of the product.
-
-  "Installation Information" for a User Product means any methods,
-procedures, authorization keys, or other information required to install
-and execute modified versions of a covered work in that User Product from
-a modified version of its Corresponding Source.  The information must
-suffice to ensure that the continued functioning of the modified object
-code is in no case prevented or interfered with solely because
-modification has been made.
-
-  If you convey an object code work under this section in, or with, or
-specifically for use in, a User Product, and the conveying occurs as
-part of a transaction in which the right of possession and use of the
-User Product is transferred to the recipient in perpetuity or for a
-fixed term (regardless of how the transaction is characterized), the
-Corresponding Source conveyed under this section must be accompanied
-by the Installation Information.  But this requirement does not apply
-if neither you nor any third party retains the ability to install
-modified object code on the User Product (for example, the work has
-been installed in ROM).
-
-  The requirement to provide Installation Information does not include a
-requirement to continue to provide support service, warranty, or updates
-for a work that has been modified or installed by the recipient, or for
-the User Product in which it has been modified or installed.  Access to a
-network may be denied when the modification itself materially and
-adversely affects the operation of the network or violates the rules and
-protocols for communication across the network.
-
-  Corresponding Source conveyed, and Installation Information provided,
-in accord with this section must be in a format that is publicly
-documented (and with an implementation available to the public in
-source code form), and must require no special password or key for
-unpacking, reading or copying.
-
-  7. Additional Terms.
-
-  "Additional permissions" are terms that supplement the terms of this
-License by making exceptions from one or more of its conditions.
-Additional permissions that are applicable to the entire Program shall
-be treated as though they were included in this License, to the extent
-that they are valid under applicable law.  If additional permissions
-apply only to part of the Program, that part may be used separately
-under those permissions, but the entire Program remains governed by
-this License without regard to the additional permissions.
-
-  When you convey a copy of a covered work, you may at your option
-remove any additional permissions from that copy, or from any part of
-it.  (Additional permissions may be written to require their own
-removal in certain cases when you modify the work.)  You may place
-additional permissions on material, added by you to a covered work,
-for which you have or can give appropriate copyright permission.
-
-  Notwithstanding any other provision of this License, for material you
-add to a covered work, you may (if authorized by the copyright holders of
-that material) supplement the terms of this License with terms:
-
-    a) Disclaiming warranty or limiting liability differently from the
-    terms of sections 15 and 16 of this License; or
-
-    b) Requiring preservation of specified reasonable legal notices or
-    author attributions in that material or in the Appropriate Legal
-    Notices displayed by works containing it; or
-
-    c) Prohibiting misrepresentation of the origin of that material, or
-    requiring that modified versions of such material be marked in
-    reasonable ways as different from the original version; or
-
-    d) Limiting the use for publicity purposes of names of licensors or
-    authors of the material; or
-
-    e) Declining to grant rights under trademark law for use of some
-    trade names, trademarks, or service marks; or
-
-    f) Requiring indemnification of licensors and authors of that
-    material by anyone who conveys the material (or modified versions of
-    it) with contractual assumptions of liability to the recipient, for
-    any liability that these contractual assumptions directly impose on
-    those licensors and authors.
-
-  All other non-permissive additional terms are considered "further
-restrictions" within the meaning of section 10.  If the Program as you
-received it, or any part of it, contains a notice stating that it is
-governed by this License along with a term that is a further
-restriction, you may remove that term.  If a license document contains
-a further restriction but permits relicensing or conveying under this
-License, you may add to a covered work material governed by the terms
-of that license document, provided that the further restriction does
-not survive such relicensing or conveying.
-
-  If you add terms to a covered work in accord with this section, you
-must place, in the relevant source files, a statement of the
-additional terms that apply to those files, or a notice indicating
-where to find the applicable terms.
-
-  Additional terms, permissive or non-permissive, may be stated in the
-form of a separately written license, or stated as exceptions;
-the above requirements apply either way.
-
-  8. Termination.
-
-  You may not propagate or modify a covered work except as expressly
-provided under this License.  Any attempt otherwise to propagate or
-modify it is void, and will automatically terminate your rights under
-this License (including any patent licenses granted under the third
-paragraph of section 11).
-
-  However, if you cease all violation of this License, then your
-license from a particular copyright holder is reinstated (a)
-provisionally, unless and until the copyright holder explicitly and
-finally terminates your license, and (b) permanently, if the copyright
-holder fails to notify you of the violation by some reasonable means
-prior to 60 days after the cessation.
-
-  Moreover, your license from a particular copyright holder is
-reinstated permanently if the copyright holder notifies you of the
-violation by some reasonable means, this is the first time you have
-received notice of violation of this License (for any work) from that
-copyright holder, and you cure the violation prior to 30 days after
-your receipt of the notice.
-
-  Termination of your rights under this section does not terminate the
-licenses of parties who have received copies or rights from you under
-this License.  If your rights have been terminated and not permanently
-reinstated, you do not qualify to receive new licenses for the same
-material under section 10.
-
-  9. Acceptance Not Required for Having Copies.
-
-  You are not required to accept this License in order to receive or
-run a copy of the Program.  Ancillary propagation of a covered work
-occurring solely as a consequence of using peer-to-peer transmission
-to receive a copy likewise does not require acceptance.  However,
-nothing other than this License grants you permission to propagate or
-modify any covered work.  These actions infringe copyright if you do
-not accept this License.  Therefore, by modifying or propagating a
-covered work, you indicate your acceptance of this License to do so.
-
-  10. Automatic Licensing of Downstream Recipients.
-
-  Each time you convey a covered work, the recipient automatically
-receives a license from the original licensors, to run, modify and
-propagate that work, subject to this License.  You are not responsible
-for enforcing compliance by third parties with this License.
-
-  An "entity transaction" is a transaction transferring control of an
-organization, or substantially all assets of one, or subdividing an
-organization, or merging organizations.  If propagation of a covered
-work results from an entity transaction, each party to that
-transaction who receives a copy of the work also receives whatever
-licenses to the work the party's predecessor in interest had or could
-give under the previous paragraph, plus a right to possession of the
-Corresponding Source of the work from the predecessor in interest, if
-the predecessor has it or can get it with reasonable efforts.
-
-  You may not impose any further restrictions on the exercise of the
-rights granted or affirmed under this License.  For example, you may
-not impose a license fee, royalty, or other charge for exercise of
-rights granted under this License, and you may not initiate litigation
-(including a cross-claim or counterclaim in a lawsuit) alleging that
-any patent claim is infringed by making, using, selling, offering for
-sale, or importing the Program or any portion of it.
-
-  11. Patents.
-
-  A "contributor" is a copyright holder who authorizes use under this
-License of the Program or a work on which the Program is based.  The
-work thus licensed is called the contributor's "contributor version".
-
-  A contributor's "essential patent claims" are all patent claims
-owned or controlled by the contributor, whether already acquired or
-hereafter acquired, that would be infringed by some manner, permitted
-by this License, of making, using, or selling its contributor version,
-but do not include claims that would be infringed only as a
-consequence of further modification of the contributor version.  For
-purposes of this definition, "control" includes the right to grant
-patent sublicenses in a manner consistent with the requirements of
-this License.
-
-  Each contributor grants you a non-exclusive, worldwide, royalty-free
-patent license under the contributor's essential patent claims, to
-make, use, sell, offer for sale, import and otherwise run, modify and
-propagate the contents of its contributor version.
-
-  In the following three paragraphs, a "patent license" is any express
-agreement or commitment, however denominated, not to enforce a patent
-(such as an express permission to practice a patent or covenant not to
-sue for patent infringement).  To "grant" such a patent license to a
-party means to make such an agreement or commitment not to enforce a
-patent against the party.
-
-  If you convey a covered work, knowingly relying on a patent license,
-and the Corresponding Source of the work is not available for anyone
-to copy, free of charge and under the terms of this License, through a
-publicly available network server or other readily accessible means,
-then you must either (1) cause the Corresponding Source to be so
-available, or (2) arrange to deprive yourself of the benefit of the
-patent license for this particular work, or (3) arrange, in a manner
-consistent with the requirements of this License, to extend the patent
-license to downstream recipients.  "Knowingly relying" means you have
-actual knowledge that, but for the patent license, your conveying the
-covered work in a country, or your recipient's use of the covered work
-in a country, would infringe one or more identifiable patents in that
-country that you have reason to believe are valid.
-
-  If, pursuant to or in connection with a single transaction or
-arrangement, you convey, or propagate by procuring conveyance of, a
-covered work, and grant a patent license to some of the parties
-receiving the covered work authorizing them to use, propagate, modify
-or convey a specific copy of the covered work, then the patent license
-you grant is automatically extended to all recipients of the covered
-work and works based on it.
-
-  A patent license is "discriminatory" if it does not include within
-the scope of its coverage, prohibits the exercise of, or is
-conditioned on the non-exercise of one or more of the rights that are
-specifically granted under this License.  You may not convey a covered
-work if you are a party to an arrangement with a third party that is
-in the business of distributing software, under which you make payment
-to the third party based on the extent of your activity of conveying
-the work, and under which the third party grants, to any of the
-parties who would receive the covered work from you, a discriminatory
-patent license (a) in connection with copies of the covered work
-conveyed by you (or copies made from those copies), or (b) primarily
-for and in connection with specific products or compilations that
-contain the covered work, unless you entered into that arrangement,
-or that patent license was granted, prior to 28 March 2007.
-
-  Nothing in this License shall be construed as excluding or limiting
-any implied license or other defenses to infringement that may
-otherwise be available to you under applicable patent law.
-
-  12. No Surrender of Others' Freedom.
-
-  If conditions are imposed on you (whether by court order, agreement or
-otherwise) that contradict the conditions of this License, they do not
-excuse you from the conditions of this License.  If you cannot convey a
-covered work so as to satisfy simultaneously your obligations under this
-License and any other pertinent obligations, then as a consequence you may
-not convey it at all.  For example, if you agree to terms that obligate you
-to collect a royalty for further conveying from those to whom you convey
-the Program, the only way you could satisfy both those terms and this
-License would be to refrain entirely from conveying the Program.
-
-  13. Use with the GNU Affero General Public License.
-
-  Notwithstanding any other provision of this License, you have
-permission to link or combine any covered work with a work licensed
-under version 3 of the GNU Affero General Public License into a single
-combined work, and to convey the resulting work.  The terms of this
-License will continue to apply to the part which is the covered work,
-but the special requirements of the GNU Affero General Public License,
-section 13, concerning interaction through a network will apply to the
-combination as such.
-
-  14. Revised Versions of this License.
-
-  The Free Software Foundation may publish revised and/or new versions of
-the GNU General Public License from time to time.  Such new versions will
-be similar in spirit to the present version, but may differ in detail to
-address new problems or concerns.
-
-  Each version is given a distinguishing version number.  If the
-Program specifies that a certain numbered version of the GNU General
-Public License "or any later version" applies to it, you have the
-option of following the terms and conditions either of that numbered
-version or of any later version published by the Free Software
-Foundation.  If the Program does not specify a version number of the
-GNU General Public License, you may choose any version ever published
-by the Free Software Foundation.
-
-  If the Program specifies that a proxy can decide which future
-versions of the GNU General Public License can be used, that proxy's
-public statement of acceptance of a version permanently authorizes you
-to choose that version for the Program.
-
-  Later license versions may give you additional or different
-permissions.  However, no additional obligations are imposed on any
-author or copyright holder as a result of your choosing to follow a
-later version.
-
-  15. Disclaimer of Warranty.
-
-  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
-APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
-HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
-OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
-THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
-IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
-ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
-
-  16. Limitation of Liability.
-
-  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
-WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
-THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
-GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
-USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
-DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
-PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
-EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
-SUCH DAMAGES.
-
-  17. Interpretation of Sections 15 and 16.
-
-  If the disclaimer of warranty and limitation of liability provided
-above cannot be given local legal effect according to their terms,
-reviewing courts shall apply local law that most closely approximates
-an absolute waiver of all civil liability in connection with the
-Program, unless a warranty or assumption of liability accompanies a
-copy of the Program in return for a fee.
-
-                     END OF TERMS AND CONDITIONS
-
-            How to Apply These Terms to Your New Programs
-
-  If you develop a new program, and you want it to be of the greatest
-possible use to the public, the best way to achieve this is to make it
-free software which everyone can redistribute and change under these terms.
-
-  To do so, attach the following notices to the program.  It is safest
-to attach them to the start of each source file to most effectively
-state the exclusion of warranty; and each file should have at least
-the "copyright" line and a pointer to where the full notice is found.
-
-    <one line to give the program's name and a brief idea of what it does.>
-    Copyright (C) <year>  <name of author>
-
-    This program is free software: you can redistribute it and/or modify
-    it under the terms of the GNU General Public License as published by
-    the Free Software Foundation, either version 3 of the License, or
-    (at your option) any later version.
-
-    This program is distributed in the hope that it will be useful,
-    but WITHOUT ANY WARRANTY; without even the implied warranty of
-    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-    GNU General Public License for more details.
-
-    You should have received a copy of the GNU General Public License
-    along with this program.  If not, see <https://www.gnu.org/licenses/>.
-
-Also add information on how to contact you by electronic and paper mail.
-
-  If the program does terminal interaction, make it output a short
-notice like this when it starts in an interactive mode:
-
-    <program>  Copyright (C) <year>  <name of author>
-    This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
-    This is free software, and you are welcome to redistribute it
-    under certain conditions; type `show c' for details.
-
-The hypothetical commands `show w' and `show c' should show the appropriate
-parts of the General Public License.  Of course, your program's commands
-might be different; for a GUI interface, you would use an "about box".
-
-  You should also get your employer (if you work as a programmer) or school,
-if any, to sign a "copyright disclaimer" for the program, if necessary.
-For more information on this, and how to apply and follow the GNU GPL, see
-<https://www.gnu.org/licenses/>.
-
-  The GNU General Public License does not permit incorporating your program
-into proprietary programs.  If your program is a subroutine library, you
-may consider it more useful to permit linking proprietary applications with
-the library.  If this is what you want to do, use the GNU Lesser General
-Public License instead of this License.  But first, please read
-<https://www.gnu.org/licenses/why-not-lgpl.html>.
+MIT License
+
+Copyright (c) 2022-2023 Jerry Ma
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README-en.md

@@ -0,0 +1,218 @@
+# static-php-cli
+
+Compile A Statically Linked PHP With Swoole and other Extensions.
+
+Compile a purely static PHP binary file with various extensions to make PHP-cli applications more portable! 
+
+You can also use the micro binary file to package PHP source code and binary files into one for distribution!
+This function is provided by [dixyes/phpmicro](https://github.com/dixyes/phpmicro).
+
+> This branch is new version, if you are looking for old bash version of static-php-cli, see [bash-version](https://github.com/crazywhalecc/static-php-cli/tree/bash-version).
+
+[![Version](https://img.shields.io/badge/Version-2.0--beta1-green.svg?style=flat-square)]()
+[![License](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)]()
+[![](https://img.shields.io/github/actions/workflow/status/crazywhalecc/static-php-cli/build.yml?branch=refactor&label=Actions%20Build&style=flat-square)](https://github.com/crazywhalecc/static-php-cli/actions/workflows/build.yml)
+[![](https://img.shields.io/github/search/crazywhalecc/static-php-cli/TODO?label=TODO%20Counter&style=flat-square)]()
+
+## Compilation Requirements
+
+Yes, this project is written in PHP, pretty funny.
+But static-php-cli runtime only requires an environment above PHP 8.0 and `tokenizer`, `iconv` extension.
+
+Here is the architecture support status, where `CI` represents support for GitHub Action builds, 
+`Local` represents support for local builds, and blank represents not currently supported.
+
+|         | x86_64    | aarch64 |
+|---------|-----------|---------|
+| macOS   | CI, Local | Local   |
+| Linux   | CI, Local | Local   |
+| Windows |           |         |
+
+> linux-aarch64 and macOS-arm64 is not supported for GitHub Actions, if you are going to build on arm, you can build it manually on your own machine.
+
+Currently supported PHP versions for compilation are: `7.4`, `8.0`, `8.1`, `8.2`.
+
+## Usage
+
+Please first select the extension you want to compile based on the extension list below.
+
+### Supported Extensions
+
+[Supported Extension List](/ext-support.md)
+
+> If there is no extension you need here, you can submit an issue.
+
+### GitHub Actions Build
+
+Use GitHub Action to easily build a statically compiled PHP and phpmicro, 
+and at the same time define the extensions to be compiled by yourself.
+
+1. Fork me.
+2. Go to the Actions of the project and select `CI`.
+3. Select `Run workflow`, fill in the PHP version you want to compile, the target type, and the list of extensions. (extensions comma separated, e.g. `bcmath,curl,mbstring`)
+4. After waiting for about a period of time, enter the corresponding task and get `Artifacts`.
+
+If you enable `debug`, all logs will be output at build time, including compiled logs, for troubleshooting.
+
+- When using ubuntu-latest, it will build linux-x86_64 binary.
+- When using macos-latest, it will build macOS-x86_64 binary.
+
+### Manual Build
+
+Clone repo first:
+
+```bash
+git clone https://github.com/crazywhalecc/static-php-cli.git
+```
+
+If you have not installed php on your system, you can download single-file php binary and composer first.
+
+The PHP runtime for static-php-cli itself will be downloaded at `bin/php`, and composer is at `bin/composer`.
+
+```bash
+cd static-php-cli
+chmod +x bin/setup-runtime
+./bin/setup-runtime
+
+# Use this php runtime to run static-php-cli compiler
+./bin/php bin/spc
+
+# Use composer
+./bin/php bin/composer
+```
+
+Basic usage for building php and micro with some extensions:
+
+```bash
+cd static-php-cli
+composer update
+chmod +x bin/spc
+# Check system tool dependencies, fix them automatically (only support macOS) (TODO: Linux distro support)
+./bin/spc doctor
+# fetch all libraries
+./bin/spc fetch --all
+# with bcmath,openssl,tokenizer,sqlite3,pdo_sqlite,ftp,curl extension, build both CLI and phpmicro SAPI
+./bin/spc build bcmath,openssl,tokenizer,sqlite3,pdo_sqlite,ftp,curl --build-cli --build-micro
+```
+
+You can also use the parameter `--with-php=x.y` to specify the downloaded PHP version, currently supports 7.4 ~ 8.2:
+
+```bash
+# Using PHP >= 8.0 is recommended, because 7.4 cannot use phpmicro
+./bin/spc fetch --with-php=8.2 --all
+```
+
+Now we support `cli`, `micro`, `fpm`, you can use one or more of the following parameters to specify the compiled SAPI:
+
+- `--build-cli`: build static cli executable
+- `--build-micro`: build static phpmicro self-extracted executable
+- `--build-fpm`: build static fpm binary
+- `--build-all`: build all
+
+If anything goes wrong, use `--debug` option to display full terminal output:
+
+```bash
+./bin/spc build openssl,pcntl,mbstring --debug --build-all
+./bin/spc fetch --all --debug
+```
+
+### php-cli Usage
+
+> php-cli is a single static binary, you can use it like normal php installed on your system.
+
+When using the parameter `--build-cli` or `--build-all`, 
+the final compilation result will output a binary file named `./php`, 
+which can be distributed and used directly. 
+This file will be located in the directory `buildroot/bin/`, copy it out for use.
+
+```bash
+cd buildroot/bin/
+./php -v                # check version
+./php -m                # check extensions
+./php your_code.php     # run your php code
+./php your_project.phar # run your phar (project archive)
+```
+
+### micro.sfx Usage
+
+> phpmicro is a Self-Extracted Executable SAPI module, 
+> provided by [dixyes/phpmicro](https://github.com/dixyes/phpmicro). 
+> It can put php runtime and your source code together.
+
+When using the parameter `--build-all` or `--build-micro`, 
+the final compilation result will output a file named `./micro.sfx`, 
+which needs to be used with your PHP source code like `code.php`. 
+This file will be located in the path `buildroot/bin/micro.sfx`, simply copy it out for use.
+
+Prepare your project source code, which can be a single PHP file or a Phar file, for use.
+
+```bash
+echo "<?php echo 'Hello world' . PHP_EOL;" > code.php
+cat micro.sfx code.php > single-app && chmod +x single-app
+./single-app
+
+# If packing a PHAR file, replace code.php with the Phar file path.
+```
+
+> In some cases, PHAR files may not run in a micro environment.
+
+### php-fpm Usage
+
+When using the parameter `--build-all` or `--build-fpm`,
+the final compilation result will output a file named `./php-fpm`,
+This file will be located in the path `buildroot/bin/`, simply copy it out for use.
+
+In normal Linux distributions and macOS systems, the package manager will automatically generate a default fpm configuration file after installing php-fpm.
+Because php-fpm must specify a configuration file before running, the php-fpm compiled by this project will not have any configuration files, so you need to write `php-fpm.conf` and `pool.conf` configuration files yourself.
+
+Specifying `php-fpm.conf` can use the command parameter `-y`, for example: `./php-fpm -y php-fpm.conf`.
+
+## Current Status
+
+- [X] Basic CLI framework (by `symfony/console`)
+- [X] Linux support
+- [X] macOS support
+- [X] Exception handler
+- [ ] Windows support
+- [X] PHP 7.4 support
+- [X] fpm support
+
+More functions and features are coming soon, Bugs and TODOs: https://github.com/crazywhalecc/static-php-cli/issues/32
+
+## Contribution
+
+Currently, there are only a few supported extensions. 
+If the extension you need is missing, you can create an issue. 
+If you are familiar with this project, you are also welcome to initiate a pull request.
+
+The basic principles for contributing are as follows:
+
+- This project uses php-cs-fixer and phpstan as code formatting tools. Before contributing, please run `composer analyze` and `composer cs-fix` on the updated code.
+- If other open source libraries are involved, the corresponding licenses should be provided. 
+    Also, configuration files should be sorted using the command `sort-config` after modification.
+    For more information about sorting commands, see the documentation.
+- Naming conventions should be followed, such as using the extension name registered in PHP for the extension name itself, 
+    and external library names should follow the project's own naming conventions. For internal logic functions, class names, variables, etc., 
+    camelCase and underscore formats should be followed, and mixing within the same module is prohibited.
+- When compiling external libraries and creating patches, compatibility with different operating systems should be considered.
+
+## Open-Source License
+
+This project is based on the tradition of using the MIT License for old versions, 
+while the new version references source code from some other projects:
+
+- [dixyes/lwmbs](https://github.com/dixyes/lwmbs) (Mulun Permissive License)
+- [swoole/swoole-cli](https://github.com/swoole/swoole-cli) (Apache 2.0 LICENSE+SWOOLE-CLI LICENSE)
+
+Due to the special nature of this project, 
+many other open source projects such as curl and protobuf will be used during the project compilation process, 
+and they all have their own open source licenses.
+
+Please use the `dump-license`(TODO) command to export the open source licenses used in the project after compilation, 
+and comply with the corresponding project's LICENSE.
+
+## Advanced
+
+This project is pure open source project, and some modules are separated for developing.
+
+This section will be improved after refactor version released.

README.md

@@ -1,61 +1,199 @@
-# static-php-swoole
-Compile A Statically Linked PHP With Swoole and other Extensions
-编译纯静态的 PHP Binary 二进制文件，带有各种扩展（CLI 模式，暂不支持 CGI 和 FPM 模式）
+# static-php-cli
 
-[![作者QQ](https://img.shields.io/badge/version-1.0.0-green.svg)]()
+Compile A Statically Linked PHP With Swoole and other Extensions. 
 
-## 环境需求
-- 目前在 x86_64 平台试验成功，其他架构需自行测试
-- 需要 Alpine Linux（测试环境为 3.13 版本，其他版本未测试）系统（也就是说需要 musl）
-- WSL2 也是支持的
+If you are using English, see [English README](README-en.md).
+
+编译纯静态的 PHP Binary 二进制文件，带有各种扩展，让 PHP-cli 应用变得更便携！
+
+同时可以使用 micro 二进制文件，将 PHP 源码和 PHP 二进制构建为一个文件分发！（由 [dixyes/phpmicro](https://github.com/dixyes/phpmicro) 提供支持）
+
+> 此分支为重构的新版，如果你在找纯 Bash 编写的旧版本，请到 [bash-version 分支](https://github.com/crazywhalecc/static-php-cli/tree/bash-version)。
+
+[![Version](https://img.shields.io/badge/Version-2.0--beta1-green.svg?style=flat-square)]()
+[![License](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)]()
+[![](https://img.shields.io/github/actions/workflow/status/crazywhalecc/static-php-cli/build.yml?branch=refactor&label=Actions%20Build&style=flat-square)](https://github.com/crazywhalecc/static-php-cli/actions/workflows/build.yml)
+[![](https://img.shields.io/github/search/crazywhalecc/static-php-cli/TODO?label=TODO%20Counter&style=flat-square)]()
+
+## 编译环境需求
+
+是的，本项目采用 PHP 编写，编译前需要一个 PHP 环境，比较滑稽。
+但本项目默认可通过自身构建的 micro 和 static-php 二进制运行，其他只需要包含 tokenizer 扩展和 PHP 版本大于等于 8.0 即可。
+
+下面是架构支持情况，`CI` 代表支持 GitHub Action 构建，`Local` 代表支持本地构建，空 代表暂不支持。
+
+|         | x86_64    | aarch64 |
+|---------|-----------|---------|
+| macOS   | CI, Local | Local   |
+| Linux   | CI, Local | Local   |
+| Windows |           |         |
+
+> linux-aarch64 and macOS-arm64 因 GitHub 暂未提供 arm runner，如果要构建 arm 二进制，可以使用手动构建。
+
+目前支持编译的 PHP 版本为：`7.4`，`8.0`，`8.1`，`8.2`。
+
+## 使用
+
+请先根据下方扩展列表选择你要编译的扩展。
+
+### 支持的扩展情况
+
+[扩展支持列表](/ext-support.md)
+
+> 如果这里没有你需要的扩展，可以提交 Issue。
+
+### 使用 Actions 构建
+
+使用 GitHub Action 可以方便地构建一个静态编译的 PHP 和 phpmicro，同时可以自行定义要编译的扩展。
+
+1. Fork 本项目。
+2. 进入项目的 Actions，选择 CI。
+3. 选择 `Run workflow`，填入你要编译的 PHP 版本、目标类型、扩展列表。（扩展列表使用英文逗号分割，例如 `bcmath,curl,mbstring`）
+4. 等待大约一段时间后，进入对应的任务中，获取 `Artifacts`。
+
+如果你选择了 `debug`，则会在构建时输出所有日志，包括编译的日志，以供排查错误。
+
+### 手动构建
+
+先克隆本项目：
 
-## 开始
-可以直接带走此仓库中的编译好的二进制（`./php`），版本 7.4.16（swoole 版本 4.6.6）。
 ```bash
-# 自己编译
-./static-compile-php.sh
+git clone https://github.com/crazywhalecc/static-php-cli.git
 ```
-完事后在 `php-dist/bin/php` 这个二进制文件可以随意拿着去任何一个 Linux 系统运行了！
 
-## 包含扩展
-- calendar
-- ctype
-- filter
-- openssl
-- pcntl
-- iconv
-- json
-- mbstring
-- phar
-- pdo
-- gd
-- pdo_mysql
-- mysqlnd
-- sockets
-- swoole
-- redis
-- simplexml
-- dom
-- xml
-- xmlwriter
-- xmlreader
-- posix
-- tokenizer
+如果你本机没有安装 PHP，你可以通过命令下载静态编译好的 php-cli 和 Composer。
 
-## 运行示例
-编译后的状态
-![image](https://user-images.githubusercontent.com/20330940/116053556-68a30800-a6ad-11eb-88f8-aba015899e43.png)
+下载的 php 和 Composer 将保存为 `bin/php` 和 `bin/composer`。
 
-在不同系统直接运行 Swoft
-![image](https://user-images.githubusercontent.com/20330940/116053161-f16d7400-a6ac-11eb-87b8-e510c6454861.png)
+```bash
+cd static-php-cli
+chmod +x bin/setup-runtime
+./bin/setup-runtime
 
-## Todo List
-- [X] curl/libcurl 扩展静态编译
-- [ ] 可自行选择不需要编译进入的扩展
-- [ ] php.ini 内嵌或分发
-- [ ] 尝试带进去个 composer（其实自己下完全可以）
+# 使用独立的 php 运行 static-php-cli
+./bin/php bin/spc
 
-## 参考资料
-- <https://blog.terrywh.net/post/2019/php-static-openssl/>
-- <https://stackoverflow.com/a/37245653>
-- <http://blog.gaoyuan.xyz/2014/04/09/statically-compile-php/>
+# 使用 composer
+./bin/php bin/composer
+```
+
+下面是使用 static-php-cli 编译静态 php 和 micro 的基础用法：
+
+```bash
+# 克隆本项目
+cd static-php-cli
+composer update
+chmod +x bin/spc
+# 检查环境依赖，并根据提示的命令安装缺失的编译工具（目前仅支持 macOS，Linux 后续会支持）
+./bin/spc doctor
+# 拉取所有依赖库
+./bin/spc fetch --all
+# 构建包含 bcmath,openssl,tokenizer,sqlite3,pdo_sqlite,ftp,curl 扩展的 php-cli 和 micro.sfx
+./bin/spc build "bcmath,openssl,tokenizer,sqlite3,pdo_sqlite,ftp,curl" --build-cli --build-micro
+```
+
+你也可以使用参数 `--with-php=x.y` 来指定下载的 PHP 版本，目前支持 7.4 ~ 8.2：
+
+```bash
+# 优先考虑使用 >= 8.0 的 PHP 版本
+./bin/spc fetch --with-php=8.2 --all
+```
+
+其中，目前支持构建 cli，micro，fpm 三种静态二进制，使用以下参数的一个或多个来指定编译的 SAPI：
+
+- `--build-cli`：构建 cli 二进制
+- `--build-micro`：构建 phpmicro 自执行二进制
+- `--build-fpm`：构建 fpm
+- `--build-all`：构建所有
+
+如果出现了任何错误，可以使用 `--debug` 参数来展示完整的输出日志，以供排查错误：
+
+```bash
+./bin/spc build openssl,pcntl,mbstring --debug --build-all
+./bin/spc fetch --all --debug
+```
+
+### 使用 php-cli
+
+> php-cli 是一个静态的二进制文件，类似 Go、Rust 语言编译后的单个可移植的二进制文件。
+
+采用参数 `--build-cli` 或`--build-all` 参数时，最后编译结果会输出一个 `./php` 的二进制文件，此文件可分发、可直接使用。
+该文件编译后会存放在 `buildroot/bin/` 目录中，名称为 `php`，拷贝出来即可。
+
+```bash
+cd buildroot/bin/
+./php -v                # 检查版本
+./php -m                # 检查编译的扩展
+./php your_code.php     # 运行代码
+./php your_project.phar # 运行打包为 phar 单文件的项目
+```
+
+### 使用 micro.sfx
+
+> phpmicro 是一个提供自执行二进制 PHP 的项目，本项目依赖 phpmicro 进行编译自执行二进制。详见 [dixyes/phpmicro](https://github.com/dixyes/phpmicro)。
+
+采用项目参数 `--build-micro` 或 `--build-all` 时，最后编译结果会输出一个 `./micro.sfx` 的文件，此文件需要配合你的 PHP 源码使用。
+该文件编译后会存放在 `buildroot/bin/` 目录中，拷贝出来即可。
+
+使用时应准备好你的项目源码文件，可以是单个 PHP 文件，也可以是 Phar 文件。
+
+```bash
+echo "<?php echo 'Hello world' . PHP_EOL;" > code.php
+cat micro.sfx code.php > single-app && chmod +x single-app
+./single-app
+
+# 如果打包 PHAR 文件，仅需把 code.php 更换为 phar 文件路径即可
+```
+
+> 有些情况下的 phar 文件可能无法在 micro 环境下运行。
+
+### 使用 php-fpm
+
+采用项目参数 `--build-fpm` 或 `--build-all` 时，最后编译结果会输出一个 `./php-fpm` 的文件。
+该文件存放在 `buildroot/bin/` 目录，拷贝出来即可使用。
+
+在正常的 Linux 发行版和 macOS 系统中，安装 php-fpm 后包管理会自动生成默认的 fpm 配置文件。
+因为 php-fpm 必须指定配置文件才可启动，本项目编译的 php-fpm 不会带任何配置文件，所以需自行编写 `php-fpm.conf` 和 `pool.conf` 配置文件。
+
+指定 `php-fpm.conf` 可以使用命令参数 `-y`，例如：`./php-fpm -y php-fpm.conf`。
+
+## 项目支持情况
+
+- [X] 基础结构编写（采用 `symfony/console`）
+- [X] 错误处理
+- [X] macOS 支持
+- [ ] Windows 支持
+- [X] Linux 支持
+- [X] PHP 7.4 支持
+- [X] fpm 支持
+
+更多功能和特性正在陆续支持中，详见：https://github.com/crazywhalecc/static-php-cli/issues/32
+
+## 贡献
+
+目前支持的扩展较少，如果缺少你需要的扩展，可发起 Issue。如果你对本项目较熟悉，也欢迎为本项目发起 Pull Request。
+
+贡献基本原则如下：
+
+- 项目采用了 php-cs-fixer、phpstan 作为代码规范工具，贡献前请对更新的代码执行 `composer analyze` 和 `composer cs-fix`。
+- 涉及到其他开源库的部分应提供对应库的协议，同时对配置文件在修改后采用命令 `sort-config` 排序。有关排序的命令，见文档。
+- 应遵循命名规范，例如扩展名称应采取 PHP 内注册的扩展名本身，外部库名应遵循项目本身的名称，内部逻辑的函数、类名、变量等应遵循驼峰、下划线等格式，禁止同一模块混用。
+- 涉及编译外部库的命令和 Patch 时应注意兼容不同操作系统。
+
+另外，添加新扩展的贡献方式，可以参考下方 `进阶`。
+
+## 开源协议
+
+本项目依据旧版本惯例采用 MIT License 开源，自身的部分代码引用或修改自以下项目：
+
+- [dixyes/lwmbs](https://github.com/dixyes/lwmbs)（木兰宽松许可证）
+- [swoole/swoole-cli](https://github.com/swoole/swoole-cli)（Apache 2.0 LICENSE、SWOOLE-CLI LICENSE）
+
+因本项目的特殊性，使用项目编译过程中会使用很多其他开源项目，例如 curl、protobuf 等，它们都有各自的开源协议。
+请在编译完成后，使用命令 `dump-license`(TODO) 导出项目使用项目的开源协议，并遵守对应项目的 LICENSE。
+
+## 进阶
+
+本项目重构分支为模块化编写。
+
+TODO：这部分将在基础功能完成后编写完成。

bin/setup-runtime

@@ -0,0 +1,48 @@
+#!/usr/bin/env bash
+
+# set error-quit, verbose, non-variable-quit
+set -eu
+# see what system used
+__OS__=$(uname -s)
+# see what arch used
+__ARCH__=$(uname -m)
+# format arch name
+case $__ARCH__ in
+arm64 | aarch64) __ARCH__=arm64 ;;
+x86_64|x64) __ARCH__=x64 ;;
+*) ;;
+esac
+
+# format uname
+case $__OS__ in
+Darwin) __OS_FIXED__=macos ;;
+Linux) __OS_FIXED__=linux ;;
+*) echo "Current OS is not supported" && exit 1 ;;
+esac
+
+# set project dir
+__DIR__=$(cd "$(dirname "$0")" && pwd)
+__PROJECT__=$(cd ${__DIR__}/../ && pwd)
+
+# set download dir
+__PHP_RUNTIME_URL__="https://github.com/swoole/swoole-src/releases/download/v4.8.13/swoole-cli-v4.8.13-${__OS_FIXED__}-${__ARCH__}.tar.xz"
+__COMPOSER_URL__="https://getcomposer.org/download/latest-stable/composer.phar"
+
+# download static-php binary (currently using swoole-cli temporarily)
+test -d ${__PROJECT__}/downloads || mkdir ${__PROJECT__}/downloads
+# download static php binary
+test -f ${__PROJECT__}/downloads/runtime.tar.xz || { echo "Downloading $__PHP_RUNTIME_URL__ ..." && curl -#fSL -o ${__PROJECT__}/downloads/runtime.tar.xz "$__PHP_RUNTIME_URL__" ; }
+test -f ${__DIR__}/php || { tar -xf ${__PROJECT__}/downloads/runtime.tar.xz -C ${__DIR__}/ && mv ${__DIR__}/swoole-cli ${__DIR__}/php && rm ${__DIR__}/LICENSE ; } # (TODO: temporarily use swoole-cli as php)
+chmod +x ${__DIR__}/php
+# download composer
+test -f ${__DIR__}/composer || curl -#fSL -o ${__DIR__}/composer "$__COMPOSER_URL__"
+chmod +x ${__DIR__}/composer
+# sanity check for php and composer
+${__DIR__}/php -v >/dev/null || { echo "Failed to run php" && exit 1; }
+${__DIR__}/php ${__DIR__}/composer --version >/dev/null || { echo "Failed to run composer" && exit 1; }
+
+echo "Setup runtime OK!"
+echo "runtime bin path needs to add manually by command below:"
+echo ""
+echo "    export PATH=\"${__DIR__}:\$PATH\""
+echo ""

bin/spc

@@ -0,0 +1,16 @@
+#!/usr/bin/env php
+<?php
+
+require_once __DIR__ . '/../vendor/autoload.php';
+
+// 防止 Micro 打包状态下不支持中文的显示（虽然这个项目目前好像没输出过中文？）
+if (PHP_OS_FAMILY === 'Windows' && Phar::running()) {
+    exec('CHCP 65001');
+}
+
+// 跑，反正一条命令跑就对了
+try {
+    (new \SPC\ConsoleApplication())->run();
+} catch (Exception $e) {
+    \SPC\exception\ExceptionHandler::getInstance()->handle($e);
+}

captainhook.json

@@ -0,0 +1,44 @@
+{
+    "pre-push": {
+        "enabled": true,
+        "actions": [
+            {
+                "action": "composer analyse"
+            }
+        ]
+    },
+    "pre-commit": {
+        "enabled": true,
+        "actions": [
+            {
+                "action": "composer cs-fix -- --config=.php-cs-fixer.php --dry-run --diff {$STAGED_FILES|of-type:php}",
+                "conditions": [
+                    {
+                        "exec": "\\CaptainHook\\App\\Hook\\Condition\\FileStaged\\OfType",
+                        "args": ["php"]
+                    }
+                ]
+            }
+        ]
+    },
+    "post-change": {
+        "enabled": true,
+        "actions": [
+            {
+                "action": "composer install",
+                "options": [],
+                "conditions": [
+                    {
+                        "exec": "\\CaptainHook\\App\\Hook\\Condition\\FileChanged\\Any",
+                        "args": [
+                            [
+                                "composer.json",
+                                "composer.lock"
+                            ]
+                        ]
+                    }
+                ]
+            }
+        ]
+    }
+}

composer.json

@@ -0,0 +1,51 @@
+{
+    "name": "crazywhalecc/static-php-cli",
+    "description": "Build single static PHP binary, with PHP project together, with popular extensions included.",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "jerry",
+            "email": "admin@zhamao.me"
+        }
+    ],
+    "require": {
+        "php": ">= 8.0",
+        "ext-tokenizer": "*",
+        "ext-iconv": "*",
+        "symfony/console": "^6 || ^5 || ^4",
+        "zhamao/logger": "^1.0",
+        "crazywhalecc/cli-helper": "^0.1.0",
+        "nunomaduro/collision": "*"
+    },
+    "require-dev": {
+        "friendsofphp/php-cs-fixer": "^3.2 != 3.7.0",
+        "phpstan/phpstan": "^1.1",
+        "captainhook/captainhook": "^5.10",
+        "captainhook/plugin-composer": "^5.3"
+    },
+    "autoload": {
+        "psr-4": {
+            "SPC\\": "src/SPC"
+        },
+        "files": [
+            "src/globals/defines.php",
+            "src/globals/functions.php"
+        ]
+    },
+    "bin": [
+        "bin/spc"
+    ],
+    "scripts": {
+        "analyse": "phpstan analyse --memory-limit 300M",
+        "cs-fix": "php-cs-fixer fix",
+        "test": "bin/phpunit --no-coverage"
+    },
+    "config": {
+        "allow-plugins": {
+            "phpstan/extension-installer": true,
+            "captainhook/plugin-composer": true
+        },
+        "optimize-autoloader": true,
+        "sort-packages": true
+    }
+}

config/ext.json

@@ -0,0 +1,408 @@
+{
+    "bcmath": {
+        "type": "builtin"
+    },
+    "bz2": {
+        "type": "builtin",
+        "arg-type": "with-prefix",
+        "lib-depends": [
+            "bzip2"
+        ]
+    },
+    "calendar": {
+        "type": "builtin"
+    },
+    "ctype": {
+        "type": "builtin"
+    },
+    "curl": {
+        "type": "builtin",
+        "arg-type": "custom",
+        "lib-depends": [
+            "curl"
+        ]
+    },
+    "dba": {
+        "type": "builtin",
+        "arg-type-windows": "with"
+    },
+    "dom": {
+        "type": "builtin",
+        "arg-type": "custom",
+        "arg-type-windows": "with",
+        "lib-depends": [
+            "libxml2",
+            "zlib"
+        ]
+    },
+    "exif": {
+        "type": "builtin"
+    },
+    "ffi": {
+        "arg-type": "custom",
+        "type": "builtin",
+        "lib-depends": [
+            "libffi"
+        ]
+    },
+    "fileinfo": {
+        "type": "builtin"
+    },
+    "filter": {
+        "type": "builtin"
+    },
+    "ftp": {
+        "type": "builtin",
+        "lib-suggests": [
+            "openssl"
+        ]
+    },
+    "gd": {
+        "type": "builtin",
+        "arg-type": "custom",
+        "arg-type-windows": "with",
+        "lib-depends": [
+            "zlib",
+            "libpng"
+        ],
+        "ext-depends": [
+            "zlib"
+        ],
+        "lib-suggests": [
+            "gd",
+            "libavif",
+            "libwebp",
+            "libjpeg",
+            "xpm",
+            "freetype"
+        ],
+        "lib-depends-windows": [
+            "libiconv",
+            "freetype",
+            "libjpeg",
+            "zlib",
+            "libpng",
+            "xpm"
+        ],
+        "lib-suggests-windows": [
+            "gd",
+            "libavif",
+            "libwebp"
+        ]
+    },
+    "gettext": {
+        "type": "builtin",
+        "arg-type": "with",
+        "lib-depends": [
+            "gettext"
+        ]
+    },
+    "gmp": {
+        "type": "builtin",
+        "arg-type": "with-prefix",
+        "lib-depends": [
+            "gmp"
+        ]
+    },
+    "iconv": {
+        "type": "builtin",
+        "arg-type": "with-prefix",
+        "lib-depends-windows": [
+            "libiconv"
+        ]
+    },
+    "imap": {
+        "type": "builtin",
+        "arg-type": "with",
+        "lib-depends": [
+            "imap"
+        ],
+        "lib-suggests": [
+            "kerberos"
+        ]
+    },
+    "intl": {
+        "type": "builtin",
+        "lib-depends": [
+            "icu"
+        ]
+    },
+    "ldap": {
+        "type": "builtin",
+        "arg-type": "with",
+        "lib-depends": [
+            "ldap"
+        ]
+    },
+    "mbregex": {
+        "type": "builtin",
+        "lib-depends": [
+            "onig"
+        ]
+    },
+    "mbstring": {
+        "type": "builtin",
+        "arg-type": "custom",
+        "lib-depends": [
+            "onig"
+        ]
+    },
+    "mongodb": {
+        "type": "external",
+        "source": "mongodb"
+    },
+    "mysqli": {
+        "type": "builtin",
+        "arg-type": "with",
+        "ext-depends": [
+            "mysqlnd"
+        ]
+    },
+    "mysqlnd": {
+        "type": "builtin",
+        "arg-type-windows": "with"
+    },
+    "opcache": {
+        "type": "builtin"
+    },
+    "openssl": {
+        "type": "builtin",
+        "arg-type": "custom",
+        "lib-depends": [
+            "openssl"
+        ]
+    },
+    "pcntl": {
+        "type": "builtin",
+        "unix-only": true
+    },
+    "pdo": {
+        "type": "builtin"
+    },
+    "pdo_mysql": {
+        "type": "builtin",
+        "arg-type": "with",
+        "ext-depends": [
+            "pdo",
+            "mysqlnd"
+        ]
+    },
+    "pdo_pgsql": {
+        "type": "builtin",
+        "arg-type": "with",
+        "ext-depends": [
+            "pdo"
+        ],
+        "lib-depends": [
+            "pq"
+        ]
+    },
+    "pdo_sqlite": {
+        "type": "builtin",
+        "arg-type": "with",
+        "ext-depends": [
+            "pdo",
+            "sqlite3"
+        ],
+        "lib-depends": [
+            "sqlite"
+        ]
+    },
+    "phar": {
+        "type": "builtin",
+        "ext-depends": [
+            "zlib"
+        ]
+    },
+    "posix": {
+        "type": "builtin",
+        "unix-only": true
+    },
+    "protobuf": {
+        "type": "external",
+        "source": "protobuf"
+    },
+    "pspell": {
+        "type": "builtin",
+        "arg-type": "with",
+        "lib-depends": [
+            "aspell"
+        ]
+    },
+    "readline": {
+        "type": "builtin",
+        "arg-type": "with",
+        "lib-depends": [
+            "readline"
+        ],
+        "lib-suggests": [
+            "libedit",
+            "ncurses"
+        ]
+    },
+    "redis": {
+        "type": "external",
+        "source": "redis",
+        "arg-type": "custom"
+    },
+    "session": {
+        "type": "builtin"
+    },
+    "shmop": {
+        "type": "builtin"
+    },
+    "simplexml": {
+        "type": "builtin",
+        "arg-type": "custom",
+        "arg-type-windows": "with",
+        "lib-depends": [
+            "libxml2"
+        ]
+    },
+    "snmp": {
+        "type": "builtin",
+        "arg-type": "with",
+        "lib-depends": [
+            "net-snmp"
+        ]
+    },
+    "soap": {
+        "type": "builtin",
+        "arg-type": "custom",
+        "lib-depends": [
+            "libxml2"
+        ]
+    },
+    "sockets": {
+        "type": "builtin"
+    },
+    "sodium": {
+        "type": "builtin",
+        "arg-type": "with",
+        "lib-depends": [
+            "sodium"
+        ]
+    },
+    "sqlite3": {
+        "type": "builtin",
+        "arg-type": "custom",
+        "lib-depends": [
+            "sqlite"
+        ]
+    },
+    "swoole": {
+        "type": "external",
+        "source": "swoole",
+        "arg-type": "custom",
+        "lib-depends": [
+            "openssl"
+        ],
+        "ext-depends": [
+            "openssl"
+        ],
+        "ext-suggests": [
+            "curl"
+        ],
+        "unix-only": true
+    },
+    "inotify": {
+        "type": "external",
+        "source": "inotify"
+    },
+    "swow": {
+        "type": "external",
+        "source": "swow",
+        "arg-type": "custom",
+        "lib-suggests": [
+            "openssl",
+            "curl"
+        ],
+        "ext-suggests": [
+            "openssl",
+            "curl"
+        ]
+    },
+    "sysvmsg": {
+        "type": "builtin",
+        "unix-only": true
+    },
+    "sysvsem": {
+        "type": "builtin",
+        "unix-only": true
+    },
+    "sysvshm": {
+        "type": "builtin",
+        "unix-only": true
+    },
+    "tidy": {
+        "type": "builtin",
+        "arg-type": "with",
+        "lib-depends": [
+            "tidy"
+        ]
+    },
+    "tokenizer": {
+        "type": "builtin"
+    },
+    "xml": {
+        "type": "builtin",
+        "arg-type": "custom",
+        "arg-type-windows": "with",
+        "lib-depends": [
+            "libxml2"
+        ]
+    },
+    "xmlreader": {
+        "type": "builtin",
+        "arg-type": "custom",
+        "lib-depends": [
+            "libxml2"
+        ]
+    },
+    "xmlwriter": {
+        "type": "builtin",
+        "arg-type": "custom",
+        "lib-depends": [
+            "libxml2"
+        ]
+    },
+    "xsl": {
+        "type": "builtin",
+        "arg-type": "with",
+        "lib-depends": [
+            "libxslt"
+        ]
+    },
+    "yaml": {
+        "type": "external",
+        "source": "yaml",
+        "arg-type": "with-prefix",
+        "lib-depends": [
+            "libyaml"
+        ]
+    },
+    "zip": {
+        "type": "builtin",
+        "arg-type": "custom",
+        "arg-type-windows": "enable",
+        "lib-depends": [
+            "libzip"
+        ]
+    },
+    "zlib": {
+        "type": "builtin",
+        "arg-type": "with",
+        "arg-type-windows": "enable",
+        "lib-depends": [
+            "zlib"
+        ]
+    },
+    "zstd": {
+        "type": "external",
+        "source": "ext-zstd",
+        "arg-type": "custom",
+        "lib-depends": [
+            "zstd"
+        ]
+    }
+}

config/lib.json

@@ -0,0 +1,384 @@
+{
+    "brotli": {
+        "source": "brotli",
+        "static-libs-unix": [
+            "libbrotlidec-static.a",
+            "libbrotlienc-static.a",
+            "libbrotlicommon-static.a"
+        ],
+        "static-libs-windows": [
+            "brotlicommon-static.lib",
+            "brotlienc-static.lib",
+            "brotlidec-static.lib"
+        ],
+        "headers": [
+            "brotli"
+        ]
+    },
+    "bzip2": {
+        "source": "bzip2",
+        "static-libs-unix": [
+            "libbz2.a"
+        ],
+        "static-libs-windows": [
+            [
+                "libbz2.lib",
+                "libbz2_a.lib"
+            ]
+        ],
+        "headers": [
+            "bzlib.h"
+        ]
+    },
+    "curl": {
+        "source": "curl",
+        "static-libs-unix": [
+            "libcurl.a"
+        ],
+        "static-libs-windows": [
+            "libcurl.lib"
+        ],
+        "headers": [
+            "curl"
+        ],
+        "lib-depends-unix": [
+            "zlib"
+        ],
+        "lib-suggests": [
+            "libssh2",
+            "brotli",
+            "nghttp2",
+            "zstd",
+            "openssl"
+        ],
+        "lib-suggests-windows": [
+            "zlib",
+            "libssh2",
+            "brotli",
+            "nghttp2",
+            "zstd",
+            "openssl",
+            "idn2",
+            "psl"
+        ],
+        "frameworks": [
+            "CoreFoundation",
+            "SystemConfiguration"
+        ]
+    },
+    "postgresql": {
+        "source": "postgresql",
+        "static-libs-unix": [
+            "libpg.a"
+        ]
+    },
+    "freetype": {
+        "source": "freetype",
+        "static-libs-unix": [
+            "libfreetype.a"
+        ],
+        "headers-unix": [
+            "freetype2/freetype/freetype.h",
+            "freetype2/ft2build.h"
+        ]
+    },
+    "gmp": {
+        "source": "gmp",
+        "static-libs-unix": [
+            "libgmp.a"
+        ],
+        "static-libs-windows": [
+            "libgmp.lib"
+        ],
+        "headers": [
+            "gmp.h"
+        ]
+    },
+    "libffi": {
+        "source": "libffi",
+        "static-libs-unix": [
+            "libffi.a"
+        ],
+        "static-libs-windows": [
+            "libffi.lib"
+        ],
+        "headers-unix": [
+            "ffi.h",
+            "ffitarget.h"
+        ],
+        "headers-windows": [
+            "ffi.h",
+            "fficonfig.h",
+            "ffitarget.h"
+        ]
+    },
+    "libiconv": {
+        "source": "libiconv",
+        "static-libs-unix": [
+            "libiconv.a"
+        ],
+        "headers": [
+            "iconv.h",
+            "libcharset.h",
+            "localcharset.h"
+        ]
+    },
+    "libmcrypt": {
+        "source": "libmcrypt",
+        "static-libs-unix": [
+            "libmcrypt.a"
+        ]
+    },
+    "libpng": {
+        "source": "libpng",
+        "static-libs-unix": [
+            "libpng.a"
+        ],
+        "static-libs-windows": [
+            "libpng16_static.lib"
+        ],
+        "headers-unix": [
+            "png.h",
+            "pngconf.h",
+            "pnglibconf.h"
+        ],
+        "headers-windows": [
+            "png.h",
+            "pngconf.h"
+        ],
+        "lib-depends": [
+            "zlib"
+        ]
+    },
+    "libssh2": {
+        "source": "libssh2",
+        "static-libs-unix": [
+            "libssh2.a"
+        ],
+        "static-libs-windows": [
+            "libssh2.lib"
+        ],
+        "headers": [
+            "libssh2.h",
+            "libssh2_publickey.h",
+            "libssh2_sftp.h"
+        ],
+        "lib-depends": [
+            "openssl"
+        ],
+        "lib-suggests": [
+            "zlib"
+        ]
+    },
+    "libxml2": {
+        "source": "libxml2",
+        "static-libs-unix": [
+            "libxml2.a"
+        ],
+        "static-libs-windows": [
+            [
+                "libxml2s.lib",
+                "libxml2_a.lib"
+            ]
+        ],
+        "headers": [
+            "libxml2"
+        ],
+        "lib-depends": [
+            "libiconv"
+        ],
+        "lib-suggests": [
+            "xz",
+            "zlib"
+        ],
+        "lib-suggests-windows": [
+            "icu",
+            "xz",
+            "zlib",
+            "pthreads4w"
+        ]
+    },
+    "libyaml": {
+        "source": "libyaml",
+        "static-libs-unix": [
+            "libyaml.a"
+        ],
+        "static-libs-windows": [
+            "yaml.lib"
+        ],
+        "headers": [
+            "yaml.h"
+        ]
+    },
+    "libzip": {
+        "source": "libzip",
+        "static-libs-unix": [
+            "libzip.a"
+        ],
+        "static-libs-windows": [
+            [
+                "zip.lib",
+                "libzip_a.lib"
+            ]
+        ],
+        "headers": [
+            "zip.h",
+            "zipconf.h"
+        ],
+        "lib-depends": [
+            "zlib"
+        ],
+        "lib-suggests": [
+            "bzip2",
+            "xz",
+            "zstd",
+            "openssl"
+        ]
+    },
+    "mcrypt": {
+        "source": "mcrypt",
+        "static-libs-unix": [
+            "libmcrypt.a"
+        ]
+    },
+    "nghttp2": {
+        "source": "nghttp2",
+        "static-libs-unix": [
+            "libnghttp2.a"
+        ],
+        "static-libs-windows": [
+            "nghttp2.lib"
+        ],
+        "headers": [
+            "nghttp2"
+        ],
+        "lib-depends": [
+            "zlib",
+            "openssl"
+        ],
+        "lib-suggests": [
+            "libxml2",
+            "libev",
+            "libcares",
+            "libngtcp2",
+            "libnghttp3",
+            "libbpf",
+            "libevent-openssl",
+            "jansson",
+            "jemalloc",
+            "systemd",
+            "cunit"
+        ]
+    },
+    "onig": {
+        "source": "onig",
+        "static-libs-unix": [
+            "libonig.a"
+        ],
+        "static-libs-windows": [
+            [
+                "onig.lib",
+                "onig_a.lib"
+            ]
+        ],
+        "headers": [
+            "oniggnu.h",
+            "oniguruma.h"
+        ]
+    },
+    "openssl": {
+        "source": "openssl",
+        "static-libs-unix": [
+            "libssl.a",
+            "libcrypto.a"
+        ],
+        "static-libs-windows": [
+            "libssl.lib",
+            "libcrypto.lib"
+        ],
+        "headers": [
+            "openssl"
+        ],
+        "lib-depends": [
+            "zlib"
+        ]
+    },
+    "pthreads4w": {
+        "source": "pthreads4w",
+        "static-libs-windows": [
+            "libpthreadVC3.lib"
+        ],
+        "headers-windows": [
+            "_ptw32.h",
+            "pthread.h",
+            "sched.h",
+            "semaphore.h"
+        ]
+    },
+    "sqlite": {
+        "source": "sqlite",
+        "static-libs-unix": [
+            "libsqlite3.a"
+        ],
+        "headers-unix": [
+            "sqlite3.h",
+            "sqlite3ext.h"
+        ]
+    },
+    "xz": {
+        "source": "xz",
+        "static-libs-unix": [
+            "liblzma.a"
+        ],
+        "static-libs-windows": [
+            [
+                "liblzma.lib",
+                "liblzma_a.lib"
+            ]
+        ],
+        "headers-unix": [
+            "lzma"
+        ],
+        "headers-windows": [
+            "lzma",
+            "lzma.h"
+        ],
+        "lib-depends": [
+            "libiconv"
+        ]
+    },
+    "zlib": {
+        "source": "zlib",
+        "static-libs-unix": [
+            "libz.a"
+        ],
+        "static-libs-windows": [
+            "zlib_a.lib"
+        ],
+        "headers": [
+            "zlib.h",
+            "zconf.h"
+        ]
+    },
+    "zstd": {
+        "source": "zstd",
+        "static-libs-unix": [
+            "libzstd.a"
+        ],
+        "static-libs-windows": [
+            [
+                "zstd.lib",
+                "zstd_static.lib"
+            ]
+        ],
+        "headers-unix": [
+            "zdict.h",
+            "zstd.h",
+            "zstd_errors.h"
+        ],
+        "headers-windows": [
+            "zstd.h",
+            "zstd_errors.h"
+        ]
+    }
+}

ext-support.md

@@ -0,0 +1,74 @@
+# Extension List
+
+> - yes: supported and tested
+> - untested: supported, but not tested
+> - empty: not supported yet
+> - no with issue link: not supported yet due to issue
+> - partial with issue link: supported but not perfect due to issue
+
+|            | Linux                                                              | macOS                                                               | Windows |
+|------------|--------------------------------------------------------------------|---------------------------------------------------------------------|---------|
+| bcmath     | yes                                                                | yes                                                                 |         |
+| bz2        | yes                                                                | yes                                                                 |         |
+| calendar   | yes                                                                | yes                                                                 |         |
+| ctype      | yes                                                                | yes                                                                 |         |
+| curl       | yes                                                                | yes                                                                 |         |
+| date       | yes                                                                | yes                                                                 |         | 
+| dba        | yes                                                                | yes                                                                 |         | 
+| dom        | yes                                                                | yes                                                                 |         |
+| enchant    |                                                                    |                                                                     |         |
+| event      |                                                                    |                                                                     |         |
+| exif       | yes                                                                | yes                                                                 |         |
+| filter     | yes                                                                | yes                                                                 |         |
+| fileinfo   | yes                                                                |                                                                     |         |
+| ftp        | yes                                                                | yes                                                                 |         |
+| gd         | yes, untested                                                      | yes                                                                 |         |
+| gettext    |                                                                    |                                                                     |         |
+| gmp        | yes, untested                                                      | yes, untested                                                       |         |
+| iconv      | yes                                                                |                                                                     |         |
+| inotify    | yes                                                                | yes                                                                 |         |
+| mbstring   | yes                                                                | yes                                                                 |         |
+| mcrypt     |                                                                    | [faulty](https://github.com/crazywhalecc/static-php-cli/issues/32)  |         |
+| mongodb    | yes, untested                                                      |                                                                     |         |
+| mysqli     |                                                                    |                                                                     |         |
+| mysqlnd    | yes                                                                | yes                                                                 |         |
+| openssl    | yes                                                                | yes                                                                 |         |
+| pcntl      | yes, untested                                                      | yes                                                                 |         |
+| pdo        | yes                                                                | yes                                                                 |         |
+| pdo_mysql  | yes                                                                | yes                                                                 |         |
+| pdo_sqlite | yes                                                                | yes                                                                 |         |
+| pdo_pgsql  |                                                                    |                                                                     |         |
+| phar       | yes                                                                | yes                                                                 |         |
+| posix      | yes                                                                | yes                                                                 |         |
+| protobuf   | yes, untested                                                      |                                                                     |         |
+| readline   |                                                                    |                                                                     |         |
+| redis      | yes                                                                | yes                                                                 |         |
+| session    | yes                                                                | yes                                                                 |         |
+| shmop      | yes, untested                                                      |                                                                     |         |
+| simplexml  | yes, untested                                                      | yes, untested                                                       |         |
+| soap       | yes, untested                                                      |                                                                     |         |
+| sockets    | yes                                                                | yes                                                                 |         |
+| sqlite3    | yes, untested                                                      | yes, untested                                                       |         |
+| swow       | yes                                                                | [faulty](https://github.com/crazywhalecc/static-php-cli/issues/32)  |         |
+| swoole     | [faulty](https://github.com/crazywhalecc/static-php-cli/issues/32) | [partial](https://github.com/crazywhalecc/static-php-cli/issues/32) |         |
+| tokenizer  | yes                                                                | yes                                                                 |         |
+| xml        | yes                                                                | yes                                                                 |         |
+| xmlreader  | yes, untested                                                      | yes, untested                                                       |         |
+| xmlwriter  | yes, untested                                                      | yes, untested                                                       |         |
+| zip        | yes, untested                                                      | yes                                                                 |         |
+| zlib       | yes                                                                | yes                                                                 |         |
+
+## Additional Requirements
+
+- phpmicro requires PHP >= 8.0
+- swoole >= 5.0 requires PHP >= 8.0
+- swow requires PHP >= 8.0
+
+## Limitations
+
+- swow and swoole cannot be compiled at the same time.
+- openssl needs manual configuration for ssl certificate. (TODO: I will write a wiki about it)
+
+## Bugs
+
+See [#32](https://github.com/crazywhalecc/static-php-cli/issues/32).

phpstan.neon

@@ -0,0 +1,12 @@
+parameters:
+  reportUnmatchedIgnoredErrors: false
+  level: 4
+  paths:
+    - ./src/
+  ignoreErrors:
+    - '#Constant .* not found#'
+    - '#Unsafe usage of new static#'
+    - '#class Fiber#'
+    - '#Attribute class JetBrains\\PhpStorm\\ArrayShape does not exist#'
+  dynamicConstantNames:
+    - PHP_OS_FAMILY

quickstart/linux/x86_64/README.md

@@ -0,0 +1,34 @@
+# 快速启动容器环境
+
+> 提供了 debian 11 构建 和 alpine 构建环境
+> 任意选一个就可以 
+
+## debian 11 构建环境
+
+```bash
+
+# 启动 debian 11 容器环境
+sh quickstart/linux/x86_64/run-debian-11-container.sh
+
+# 进入容器 
+sh quickstart/linux/x86_64/connection-static-php-cli.sh
+
+# 准备构建基础软件
+sh quickstart/linux/x86_64/debian-11-init.sh
+
+```
+
+## aline 构建环境
+
+```bash
+
+# 启动 alpine 容器环境
+sh quickstart/linux/x86_64/run-alpine-3.16-container.sh
+
+# 进入容器 
+sh sh quickstart/linux/x86_64/connection-static-php-cli.sh
+
+# 准备构建基础软件
+sh quickstart/linux/x86_64/alpine-3.16-init.sh
+
+```

quickstart/linux/x86_64/alpine-3.16-init.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+
+set -exu
+__DIR__=$(
+  cd "$(dirname "$0")"
+  pwd
+)
+
+test -f /etc/apk/repositories.save || cp /etc/apk/repositories /etc/apk/repositories.save
+sed -i 's/dl-cdn.alpinelinux.org/mirrors.tuna.tsinghua.edu.cn/g' /etc/apk/repositories
+
+apk update
+
+apk add vim alpine-sdk xz autoconf automake linux-headers clang-dev clang lld libtool cmake bison re2c gettext coreutils

quickstart/linux/x86_64/connection-static-php-cli.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+
+set -exu
+__DIR__=$(
+  cd "$(dirname "$0")"
+  pwd
+)
+
+cd ${__DIR__}
+
+docker exec -it static-php-cli-dev-1 bash

quickstart/linux/x86_64/debian-11-init.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+
+set -exu
+__DIR__=$(
+  cd "$(dirname "$0")"
+  pwd
+)
+
+sed -i "s@deb.debian.org@mirrors.ustc.edu.cn@g" /etc/apt/sources.list && \
+sed -i "s@security.debian.org@mirrors.ustc.edu.cn@g" /etc/apt/sources.list
+
+apt update -y
+apt install -y   git curl wget ca-certificates
+apt install -y   xz-utils autoconf automake  libclang-13-dev clang lld libtool cmake bison re2c gettext  coreutils lzip zip unzip
+apt install -y   pkg-config bzip2 flex
+
+
+# apt install build-essential linux-headers-$(uname -r)

quickstart/linux/x86_64/prepare.sh

@@ -0,0 +1,25 @@
+#!/bin/bash
+
+set -exu
+__DIR__=$(
+  cd "$(dirname "$0")"
+  pwd
+)
+__PROJECT__=$(
+  cd ${__DIR__}/../../../
+  pwd
+)
+cd ${__PROJECT__}
+
+composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
+
+chmod +x bin/spc
+
+./bin/spc fetch --all --debug
+
+./bin/spc list-ext
+
+
+#./bin/spc build "bcmath,openssl,tokenizer,sqlite3,pdo,pdo_sqlite,ftp,curl" --cc=gcc --cxx=g++  --debug
+
+./bin/spc build "bcmath,openssl,tokenizer,sqlite3,pdo,pdo_sqlite,ftp,curl" --cc=clang --cxx=clang++  --debug

quickstart/linux/x86_64/run-alpine-3.16-container.sh

@@ -0,0 +1,25 @@
+#!/bin/bash
+
+set -exu
+__DIR__=$(
+  cd "$(dirname "$0")"
+  pwd
+)
+__PROJECT__=$(
+  cd ${__DIR__}/../../../
+  pwd
+)
+cd ${__DIR__}
+
+
+{
+  docker stop static-php-cli-dev-1
+} || {
+  echo $?
+}
+cd ${__DIR__}
+IMAGE=alpine:3.16
+
+cd ${__DIR__}
+docker run --rm --name static-php-cli-dev-1 -d -v ${__PROJECT__}:/work -w /work $IMAGE tail -f /dev/null
+

quickstart/linux/x86_64/run-debian-11-container.sh

@@ -0,0 +1,25 @@
+#!/bin/bash
+
+set -exu
+__DIR__=$(
+  cd "$(dirname "$0")"
+  pwd
+)
+__PROJECT__=$(
+  cd ${__DIR__}/../../../
+  pwd
+)
+cd ${__DIR__}
+
+
+{
+  docker stop static-php-cli-dev-1
+} || {
+  echo $?
+}
+cd ${__DIR__}
+IMAGE=debian:11
+
+cd ${__DIR__}
+docker run --rm --name static-php-cli-dev-1 -d -v ${__PROJECT__}:/work -w /work $IMAGE tail -f /dev/null
+

quickstart/macOS/x86_64/prepare.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+
+set -exu
+__DIR__=$(
+  cd "$(dirname "$0")"
+  pwd
+)
+__PROJECT__=$(
+  cd ${__DIR__}/../../../
+  pwd
+)
+cd ${__PROJECT__}
+
+export PATH=${__PROJECT__}/bin/runtime:$PATH
+
+composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
+
+chmod +x bin/spc
+
+./bin/spc fetch --all --debug
+
+./bin/spc list-ext
+
+./bin/spc build "bcmath,openssl,tokenizer,sqlite3,pdo,pdo_sqlite,ftp,curl" --cc=clang --cxx=clang++  --debug

src/SPC/ConsoleApplication.php

@@ -0,0 +1,52 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC;
+
+use SPC\command\DeployCommand;
+use SPC\store\FileSystem;
+use Symfony\Component\Console\Application;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Command\HelpCommand;
+use Symfony\Component\Console\Command\ListCommand;
+
+/**
+ * spc 应用究级入口
+ */
+class ConsoleApplication extends Application
+{
+    public const VERSION = '2.0-beta2';
+
+    /**
+     * @throws \ReflectionException
+     * @throws exception\FileSystemException
+     */
+    public function __construct()
+    {
+        parent::__construct('static-php-cli', self::VERSION);
+
+        global $argv;
+
+        // 生产环境不显示详细的调试错误，只使用 symfony console 自带的错误显示
+        $this->setCatchExceptions(file_exists(ROOT_DIR . '/.prod') || !in_array('--debug', $argv));
+
+        // 通过扫描目录 src/static-php-cli/command/ 添加子命令
+        $commands = FileSystem::getClassesPsr4(ROOT_DIR . '/src/SPC/command', 'SPC\\command');
+        $this->addCommands(array_map(function ($x) { return new $x(); }, array_filter($commands, function ($y) {
+            if (is_a($y, DeployCommand::class, true) && (class_exists('\\Phar') && \Phar::running() || !class_exists('\\Phar'))) {
+                return false;
+            }
+            $reflection = new \ReflectionClass($y);
+            return !$reflection->isAbstract() && !$reflection->isInterface();
+        })));
+    }
+
+    /**
+     * 重载以去除一些不必要的默认命令
+     */
+    protected function getDefaultCommands(): array
+    {
+        return [new HelpCommand(), new ListCommand()];
+    }
+}

src/SPC/builder/BuilderBase.php

@@ -0,0 +1,251 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder;
+
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\store\Config;
+use SPC\store\FileSystem;
+use SPC\util\CustomExt;
+use SPC\util\DependencyUtil;
+
+abstract class BuilderBase
+{
+    /** @var bool 是否启用 ZTS 线程安全 */
+    public bool $zts = false;
+
+    /** @var string 编译目标架构 */
+    public string $arch;
+
+    /** @var string GNU 格式的编译目标架构 */
+    public string $gnu_arch;
+
+    /** @var int 编译进程数 */
+    public int $concurrency = 1;
+
+    /** @var array<string, LibraryBase> 要编译的 libs 列表 */
+    protected array $libs = [];
+
+    /** @var array<string, Extension> 要编译的扩展列表 */
+    protected array $exts = [];
+
+    /** @var array<int, string> 要编译的扩展列表（仅名字列表，用于最后生成编译的扩展列表给 micro） */
+    protected array $plain_extensions = [];
+
+    /** @var bool 本次编译是否只编译 libs，不编译 PHP */
+    protected bool $libs_only = false;
+
+    /**
+     * 构建指定列表的 libs
+     *
+     * @throws RuntimeException
+     * @throws FileSystemException
+     */
+    public function buildLibs(array $libraries): void
+    {
+        // 通过扫描目录查找 lib
+        $support_lib_list = [];
+        $classes = FileSystem::getClassesPsr4(
+            ROOT_DIR . '/src/SPC/builder/' . osfamily2dir() . '/library',
+            'SPC\\builder\\' . osfamily2dir() . '\\library'
+        );
+        foreach ($classes as $class) {
+            if (defined($class . '::NAME') && $class::NAME !== 'unknown' && Config::getLib($class::NAME) !== null) {
+                $support_lib_list[$class::NAME] = $class;
+            }
+        }
+
+        // 如果传入了空，则默认检查和安置所有支持的lib，libraries为要build的，support_lib_list为支持的列表
+        if ($libraries === [] && $this->isLibsOnly()) {
+            $libraries = array_keys($support_lib_list);
+        }
+
+        // 排序 libs，根据依赖计算一个新的列表出来
+        $libraries = DependencyUtil::getLibsByDeps($libraries);
+
+        // 这里筛选 libraries，比如纯静态模式排除掉ffi
+        if (defined('BUILD_ALL_STATIC') && BUILD_ALL_STATIC) {
+            $k = array_search('libffi', $libraries, true);
+            $k !== false && array_splice($libraries, $k, 1);
+        }
+
+        // 过滤不支持的库后添加
+        foreach ($libraries as $library) {
+            if (!isset($support_lib_list[$library])) {
+                throw new RuntimeException('library [' . $library . '] is in the lib.json list but not supported to compile, but in the future I will support it!');
+            }
+            $lib = new ($support_lib_list[$library])($this);
+            $this->addLib($lib);
+        }
+
+        // 统计还没 fetch 到本地的库
+        $this->checkLibsSource();
+
+        // 计算依赖，经过这里的遍历，如果没有抛出异常，说明依赖符合要求，可以继续下面的
+        foreach ($this->libs as $lib) {
+            $lib->calcDependency();
+        }
+        foreach ($this->libs as $lib) {
+            match ($lib->tryBuild()) {
+                BUILD_STATUS_OK => logger()->info('lib [' . $lib::NAME . '] build success'),
+                BUILD_STATUS_ALREADY => logger()->notice('lib [' . $lib::NAME . '] already built'),
+                BUILD_STATUS_FAILED => logger()->error('lib [' . $lib::NAME . '] build failed'),
+                default => logger()->warning('lib [' . $lib::NAME . '] build status unknown'),
+            };
+        }
+    }
+
+    /**
+     * 添加要编译的 Lib 库
+     *
+     * @param LibraryBase $library Lib 库对象
+     */
+    public function addLib(LibraryBase $library): void
+    {
+        $this->libs[$library::NAME] = $library;
+    }
+
+    /**
+     * 获取要编译的 Lib 库对象
+     *
+     * @param string $name 库名称
+     */
+    public function getLib(string $name): ?LibraryBase
+    {
+        return $this->libs[$name] ?? null;
+    }
+
+    /**
+     * 添加要编译的扩展
+     *
+     * @param Extension $extension 扩展对象
+     */
+    public function addExt(Extension $extension): void
+    {
+        $this->exts[$extension->getName()] = $extension;
+    }
+
+    /**
+     * 获取要编译的扩展对象
+     *
+     * @param string $name 扩展名称
+     */
+    public function getExt(string $name): ?Extension
+    {
+        return $this->exts[$name] ?? null;
+    }
+
+    /**
+     * 设置本次 Builder 是否为仅编译库的模式
+     */
+    public function setLibsOnly(bool $status = true): void
+    {
+        $this->libs_only = $status;
+    }
+
+    /**
+     * 检验 ext 扩展列表是否合理，并声明 Extension 对象，检查扩展的依赖
+     *
+     * @throws FileSystemException
+     * @throws RuntimeException
+     */
+    public function proveExts(array $extensions): void
+    {
+        CustomExt::loadCustomExt();
+        foreach ($extensions as $extension) {
+            $class = CustomExt::getExtClass($extension);
+            $ext = new $class($extension, $this);
+            $this->addExt($ext);
+        }
+
+        foreach ($this->exts as $ext) {
+            // 检查下依赖就行了，作用是导入依赖给 Extension 对象，今后可以对库依赖进行选择性处理
+            $ext->checkDependency();
+        }
+
+        $this->plain_extensions = $extensions;
+    }
+
+    /**
+     * 开始构建 PHP
+     *
+     * @param int  $build_target 规则
+     * @param bool $bloat        保留
+     */
+    abstract public function buildPHP(int $build_target = BUILD_TARGET_NONE, bool $bloat = false);
+
+    /**
+     * 生成依赖的扩展编译启用参数
+     * 例如 --enable-mbstring 等
+     *
+     * @throws RuntimeException
+     * @throws FileSystemException
+     */
+    public function makeExtensionArgs(): string
+    {
+        $ret = [];
+        foreach ($this->exts as $ext) {
+            $ret[] = trim($ext->getConfigureArg());
+        }
+        logger()->info('Using configure: ' . implode(' ', $ret));
+        return implode(' ', $ret);
+    }
+
+    /**
+     * 返回是否只编译 libs 的模式
+     */
+    public function isLibsOnly(): bool
+    {
+        return $this->libs_only;
+    }
+
+    /**
+     * 获取当前即将编译的 PHP 的版本 ID，五位数那个
+     */
+    public function getPHPVersionID(): int
+    {
+        $file = file_get_contents(SOURCE_PATH . '/php-src/main/php_version.h');
+        preg_match('/PHP_VERSION_ID (\d+)/', $file, $match);
+        return intval($match[1]);
+    }
+
+    public function getBuildTypeName(int $type): string
+    {
+        $ls = [];
+        if (($type & BUILD_TARGET_CLI) === BUILD_TARGET_CLI) {
+            $ls[] = 'cli';
+        }
+        if (($type & BUILD_TARGET_MICRO) === BUILD_TARGET_MICRO) {
+            $ls[] = 'micro';
+        }
+        if (($type & BUILD_TARGET_FPM) === BUILD_TARGET_FPM) {
+            $ls[] = 'fpm';
+        }
+        return implode(', ', $ls);
+    }
+
+    /**
+     * 检查是否存在 lib 库对应的源码，如果不存在，则抛出异常
+     *
+     * @throws RuntimeException
+     */
+    protected function checkLibsSource(): void
+    {
+        $not_downloaded = [];
+        foreach ($this->libs as $lib) {
+            if (!file_exists($lib->getSourceDir())) {
+                $not_downloaded[] = $lib::NAME;
+            }
+        }
+        if ($not_downloaded !== []) {
+            throw new RuntimeException(
+                '"' . implode(', ', $not_downloaded) .
+                '" totally ' . count($not_downloaded) .
+                ' source' . (count($not_downloaded) === 1 ? '' : 's') .
+                ' not downloaded, maybe you need to "fetch" ' . (count($not_downloaded) === 1 ? 'it' : 'them') . ' first?'
+            );
+        }
+    }
+}

src/SPC/builder/BuilderProvider.php

@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder;
+
+use SPC\builder\linux\LinuxBuilder;
+use SPC\builder\macos\MacOSBuilder;
+use SPC\builder\windows\WindowsBuilder;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
+use Symfony\Component\Console\Input\InputInterface;
+
+/**
+ * 用于生成对应系统环境的 Builder 对象的类
+ */
+class BuilderProvider
+{
+    /**
+     * @throws RuntimeException
+     */
+    public static function makeBuilderByInput(InputInterface $input): BuilderBase
+    {
+        return match (PHP_OS_FAMILY) {
+            // 'Windows' => new WindowsBuilder(
+            //   binary_sdk_dir: $input->getOption('with-sdk-binary-dir'),
+            //    vs_ver: $input->getOption('vs-ver'),
+            //    arch: $input->getOption('arch'),
+            // ),
+            'Darwin' => new MacOSBuilder(
+                cc: $input->getOption('cc'),
+                cxx: $input->getOption('cxx'),
+                arch: $input->getOption('arch'),
+            ),
+            'Linux' => new LinuxBuilder(
+                cc: $input->getOption('cc'),
+                cxx: $input->getOption('cxx'),
+                arch: $input->getOption('arch'),
+            ),
+            default => throw new WrongUsageException('Current OS "' . PHP_OS_FAMILY . '" is not supported yet'),
+        };
+    }
+}

src/SPC/builder/Extension.php

@@ -0,0 +1,198 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder;
+
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
+use SPC\store\Config;
+
+class Extension
+{
+    protected array $dependencies = [];
+
+    /**
+     * @throws FileSystemException
+     * @throws RuntimeException
+     * @throws WrongUsageException
+     */
+    public function __construct(protected string $name, protected BuilderBase $builder)
+    {
+        $ext_type = Config::getExt($this->name, 'type');
+        $unix_only = Config::getExt($this->name, 'unix-only', false);
+        $windows_only = Config::getExt($this->name, 'windows-only', false);
+        if (PHP_OS_FAMILY !== 'Windows' && $windows_only) {
+            throw new RuntimeException("{$ext_type} extension {$name} is not supported on Linux and macOS platform");
+        }
+        if (PHP_OS_FAMILY === 'Windows' && $unix_only) {
+            throw new RuntimeException("{$ext_type} extension {$name} is not supported on Windows platform");
+        }
+    }
+
+    /**
+     * 获取开启该扩展的 PHP 编译添加的参数
+     *
+     * @throws FileSystemException|RuntimeException
+     * @throws WrongUsageException
+     */
+    public function getConfigureArg(): string
+    {
+        $arg = $this->getEnableArg();
+        switch (PHP_OS_FAMILY) {
+            case 'Windows':
+                $arg = $this->getWindowsConfigureArg();
+                break;
+            case 'Darwin':
+            case 'Linux':
+                $arg .= $this->getUnixConfigureArg();
+                break;
+        }
+        return $arg;
+    }
+
+    /**
+     * 根据 ext 的 arg-type 获取对应开启的参数，一般都是 --enable-xxx 和 --with-xxx
+     *
+     * @throws FileSystemException
+     * @throws RuntimeException
+     * @throws WrongUsageException
+     */
+    public function getEnableArg(): string
+    {
+        $_name = str_replace('_', '-', $this->name);
+        return match ($arg_type = Config::getExt($this->name, 'arg-type', 'enable')) {
+            'enable' => '--enable-' . $_name . ' ',
+            'with' => '--with-' . $_name . ' ',
+            'with-prefix' => '--with-' . $_name . '="' . BUILD_ROOT_PATH . '" ',
+            'none', 'custom' => '',
+            default => throw new WrongUsageException("argType does not accept {$arg_type}, use [enable/with/with-prefix] ."),
+        };
+    }
+
+    /**
+     * 导出当前扩展依赖的所有 lib 库生成的 .a 静态编译库文件，以字符串形式导出，用空格分割
+     */
+    public function getLibFilesString(): string
+    {
+        $ret = array_map(
+            fn ($x) => $x->getStaticLibFiles(),
+            $this->getLibraryDependencies(recursive: true)
+        );
+        return implode(' ', $ret);
+    }
+
+    /**
+     * 检查下依赖就行了，作用是导入依赖给 Extension 对象，今后可以对库依赖进行选择性处理
+     *
+     * @throws RuntimeException
+     * @throws FileSystemException
+     * @throws WrongUsageException
+     */
+    public function checkDependency(): static
+    {
+        foreach (Config::getExt($this->name, 'lib-depends', []) as $name) {
+            $this->addLibraryDependency($name);
+        }
+        foreach (Config::getExt($this->name, 'lib-suggests', []) as $name) {
+            $this->addLibraryDependency($name, true);
+        }
+        foreach (Config::getExt($this->name, 'ext-depends', []) as $name) {
+            $this->addExtensionDependency($name);
+        }
+        foreach (Config::getExt($this->name, 'ext-suggests', []) as $name) {
+            $this->addExtensionDependency($name, true);
+        }
+        return $this;
+    }
+
+    public function getExtensionDependency(): array
+    {
+        return array_filter($this->dependencies, fn ($x) => $x instanceof Extension);
+    }
+
+    public function getName(): string
+    {
+        return $this->name;
+    }
+
+    /**
+     * returns extension dist name
+     */
+    public function getDistName(): string
+    {
+        return $this->name;
+    }
+
+    public function getWindowsConfigureArg(): string
+    {
+        return '';
+        // Windows is not supported yet
+    }
+
+    public function getUnixConfigureArg(): string
+    {
+        return '';
+    }
+
+    /**
+     * @throws RuntimeException
+     */
+    protected function addLibraryDependency(string $name, bool $optional = false): void
+    {
+        $depLib = $this->builder->getLib($name);
+        if (!$depLib) {
+            if (!$optional) {
+                throw new RuntimeException("extension {$this->name} requires library {$name}");
+            }
+            logger()->info("enabling {$this->name} without library {$name}");
+        } else {
+            $this->dependencies[] = $depLib;
+        }
+    }
+
+    /**
+     * @throws RuntimeException
+     */
+    protected function addExtensionDependency(string $name, bool $optional = false): void
+    {
+        $depExt = $this->builder->getExt($name);
+        if (!$depExt) {
+            if (!$optional) {
+                throw new RuntimeException("{$this->name} requires extension {$name}");
+            }
+            logger()->info("enabling {$this->name} without extension {$name}");
+        } else {
+            $this->dependencies[] = $depExt;
+        }
+    }
+
+    private function getLibraryDependencies(bool $recursive = false): array
+    {
+        $ret = array_filter($this->dependencies, fn ($x) => $x instanceof LibraryBase);
+        if (!$recursive) {
+            return $ret;
+        }
+
+        $deps = [];
+
+        $added = 1;
+        while ($added !== 0) {
+            $added = 0;
+            foreach ($ret as $depName => $dep) {
+                foreach ($dep->getDependencies(true) as $depdepName => $depdep) {
+                    if (!in_array($depdepName, array_keys($deps), true)) {
+                        $deps[$depdepName] = $depdep;
+                        ++$added;
+                    }
+                }
+                if (!in_array($depName, array_keys($deps), true)) {
+                    $deps[$depName] = $dep;
+                }
+            }
+        }
+
+        return $deps;
+    }
+}

src/SPC/builder/LibraryBase.php

@@ -0,0 +1,191 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder;
+
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\store\Config;
+
+/**
+ * Lib 库的基类操作对象
+ */
+abstract class LibraryBase
+{
+    /** @var string lib 依赖名称，必须重写 */
+    public const NAME = 'unknown';
+
+    /** @var string lib 依赖的根目录 */
+    protected string $source_dir;
+
+    /** @var array 依赖列表 */
+    protected array $dependencies = [];
+
+    /**
+     * @throws RuntimeException
+     */
+    public function __construct(?string $source_dir = null)
+    {
+        if (static::NAME === 'unknown') {
+            throw new RuntimeException('no unknown!!!!!');
+        }
+        $this->source_dir = $source_dir ?? (SOURCE_PATH . '/' . static::NAME);
+    }
+
+    /**
+     * 获取 lib 库的根目录
+     */
+    public function getSourceDir(): string
+    {
+        return $this->source_dir;
+    }
+
+    /**
+     * 获取当前 lib 库的所有依赖列表
+     *
+     * @param  bool                       $recursive 是否递归获取（默认为 False）
+     * @return array<string, LibraryBase> 依赖的 Map
+     */
+    public function getDependencies(bool $recursive = false): array
+    {
+        // 非递归情况下直接返回通过 addLibraryDependency 方法添加的依赖
+        if (!$recursive) {
+            return $this->dependencies;
+        }
+
+        // 下面为递归获取依赖列表，根据依赖顺序
+        $deps = [];
+
+        $added = 1;
+        while ($added !== 0) {
+            $added = 0;
+            foreach ($this->dependencies as $depName => $dep) {
+                foreach ($dep->getDependencies(true) as $depdepName => $depdep) {
+                    if (!in_array($depdepName, array_keys($deps), true)) {
+                        $deps[$depdepName] = $depdep;
+                        ++$added;
+                    }
+                }
+                if (!in_array($depName, array_keys($deps), true)) {
+                    $deps[$depName] = $dep;
+                }
+            }
+        }
+
+        return $deps;
+    }
+
+    /**
+     * 计算依赖列表，不符合依赖将抛出异常
+     *
+     * @throws RuntimeException
+     * @throws FileSystemException
+     */
+    public function calcDependency(): void
+    {
+        // 先从配置文件添加依赖，这里根据不同的操作系统分别选择不同的元信息
+        /*
+        选择规则：
+            如果是 Windows 系统，则依次尝试有无 lib-depends-windows、lib-depends-win、lib-depends。
+            如果是 macOS 系统，则依次尝试 lib-depends-darwin、lib-depends-unix、lib-depends。
+            如果是 Linux 系统，则依次尝试 lib-depends-linux、lib-depends-unix、lib-depends。
+         */
+        foreach (Config::getLib(static::NAME, 'lib-depends', []) as $dep_name) {
+            $this->addLibraryDependency($dep_name);
+        }
+        foreach (Config::getLib(static::NAME, 'lib-suggests', []) as $dep_name) {
+            $this->addLibraryDependency($dep_name, true);
+        }
+    }
+
+    /**
+     * 获取当前库编译出来获取到的静态库文件列表
+     *
+     * @return string[]            获取编译出来后的需要的静态库文件列表
+     * @throws FileSystemException
+     * @throws RuntimeException
+     */
+    public function getStaticLibs(): array
+    {
+        return Config::getLib(static::NAME, 'static-libs', []);
+    }
+
+    /**
+     * 获取当前 lib 编译出来的 C Header 文件列表
+     *
+     * @return string[]            获取编译出来后需要的 C Header 文件列表
+     * @throws FileSystemException
+     * @throws RuntimeException
+     */
+    public function getHeaders(): array
+    {
+        return Config::getLib(static::NAME, 'headers', []);
+    }
+
+    /**
+     * 证明该库是否已编译好且就绪，如果没有就绪，内部会调用 build 来进行构建该库
+     *
+     * @throws RuntimeException
+     * @throws FileSystemException
+     */
+    public function tryBuild(bool $force_build = false): int
+    {
+        // 传入 true，表明直接编译
+        if ($force_build) {
+            logger()->info('Building required library [' . static::NAME . ']');
+            $this->build();
+            return BUILD_STATUS_OK;
+        }
+
+        // 看看这些库是不是存在，如果不存在，则调用编译并返回结果状态
+        foreach ($this->getStaticLibs() as $name) {
+            if (!file_exists(BUILD_LIB_PATH . "/{$name}")) {
+                $this->tryBuild(true);
+                return BUILD_STATUS_OK;
+            }
+        }
+        // 头文件同理
+        foreach ($this->getHeaders() as $name) {
+            if (!file_exists(BUILD_INCLUDE_PATH . "/{$name}")) {
+                $this->tryBuild(true);
+                return BUILD_STATUS_OK;
+            }
+        }
+        // 到这里说明所有的文件都存在，就跳过编译
+        return BUILD_STATUS_ALREADY;
+    }
+
+    /**
+     * 获取构建当前 lib 的 Builder 对象
+     */
+    abstract public function getBuilder(): BuilderBase;
+
+    /**
+     * 构建该库需要调用的命令和操作
+     *
+     * @throws RuntimeException
+     */
+    abstract protected function build();
+
+    /**
+     * 添加 lib 库的依赖库
+     *
+     * @param  string           $name     依赖名称
+     * @param  bool             $optional 是否是可选依赖（默认为 False）
+     * @throws RuntimeException
+     */
+    protected function addLibraryDependency(string $name, bool $optional = false): void
+    {
+        // Log::i("add $name as dep of {$this->name}");
+        $dep_lib = $this->getBuilder()->getLib($name);
+        if (!$dep_lib) {
+            if (!$optional) {
+                throw new RuntimeException(static::NAME . " requires library {$name}");
+            }
+            logger()->debug('enabling ' . static::NAME . " without {$name}");
+        } else {
+            $this->dependencies[$name] = $dep_lib;
+        }
+    }
+}

src/SPC/builder/LibraryInterface.php

@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder;
+
+interface LibraryInterface
+{
+    public function getName(): string;
+}

src/SPC/builder/extension/curl.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('curl')]
+class curl extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        return '--with-curl CURL_CFLAGS=-I"' . BUILD_INCLUDE_PATH . '" ' .
+            'CURL_LIBS="' . $this->getLibFilesString() . '"';
+    }
+}

src/SPC/builder/extension/enchant.php

@@ -0,0 +1,30 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('enchant')]
+class enchant extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        $glibs = [
+            '/Users/jerry/project/git-project/static-php-cli/buildroot/lib/libgio-2.0.a',
+            '/Users/jerry/project/git-project/static-php-cli/buildroot/lib/libglib-2.0.a',
+            '/Users/jerry/project/git-project/static-php-cli/buildroot/lib/libgmodule-2.0.a',
+            '/Users/jerry/project/git-project/static-php-cli/buildroot/lib/libgobject-2.0.a',
+            '/Users/jerry/project/git-project/static-php-cli/buildroot/lib/libgthread-2.0.a',
+            '/Users/jerry/project/git-project/static-php-cli/buildroot/lib/libintl.a',
+        ];
+        $arg = '--with-enchant="' . BUILD_ROOT_PATH . '"';
+        $arg .= ' ENCHANT2_CFLAGS=-I"' . BUILD_INCLUDE_PATH . '/enchant-2"';
+        $arg .= ' ENCHANT2_LIBS="' . $this->getLibFilesString() . '"';
+        $arg .= ' GLIB_CFLAGS=-I"' . BUILD_INCLUDE_PATH . '"';
+        $arg .= ' GLIB_LIBS="' . implode(' ', $glibs) . '"';
+        return $arg;
+    }
+}

src/SPC/builder/extension/ffi.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('ffi')]
+class ffi extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        return '--with-ffi FFI_CFLAGS=-I"' . BUILD_INCLUDE_PATH . '" ' .
+            'FFI_LIBS="' . $this->getLibFilesString() . '"';
+    }
+}

src/SPC/builder/extension/gd.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('gd')]
+class gd extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        $arg = '--enable-gd';
+        if ($this->builder->getLib('freetype')) {
+            $arg .= ' --with-freetype ' .
+                'FREETYPE2_CFLAGS=-I"' . BUILD_INCLUDE_PATH . '/freetype2" ' .
+                'FREETYPE2_LIBS="' . $this->getLibFilesString() . '"';
+        }
+        $arg .= ' PNG_CFLAGS=-I"' . BUILD_INCLUDE_PATH . '" ' .
+            'PNG_LIBS="' . $this->getLibFilesString() . '"';
+        return $arg;
+    }
+}

src/SPC/builder/extension/mbregex.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('mbregex')]
+class mbregex extends Extension
+{
+    public function getDistName(): string
+    {
+        return 'mbstring';
+    }
+}

src/SPC/builder/extension/mbstring.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('mbstring')]
+class mbstring extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        $arg = '--enable-mbstring';
+        if ($this->builder->getExt('mbregex') === null) {
+            $arg .= ' --disable-mbregex';
+        }
+        return $arg . ' ONIG_CFLAGS=-I"' . BUILD_ROOT_PATH . '" ONIG_LIBS="' . $this->getLibFilesString() . '"';
+    }
+}

src/SPC/builder/extension/openssl.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('openssl')]
+class openssl extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        return '--with-openssl OPENSSL_CFLAGS=-I"' . BUILD_INCLUDE_PATH . '" ' .
+            'OPENSSL_LIBS="' . $this->getLibFilesString() . '" ';
+    }
+}

src/SPC/builder/extension/redis.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('redis')]
+class redis extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        $arg = '--enable-redis --disable-redis-session';
+        if ($this->builder->getLib('zstd')) {
+            $arg .= ' --enable-redis-zstd --with-libzstd="' . BUILD_ROOT_PATH . '"';
+        }
+        return $arg;
+    }
+}

src/SPC/builder/extension/sqlite3.php

@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('sqlite3')]
+class sqlite3 extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        return '--with-sqlite3="' . BUILD_ROOT_PATH . '" ' .
+            'SQLITE_CFLAGS=-I"' . BUILD_INCLUDE_PATH . '" ' .
+            'SQLITE_LIBS="' . $this->getLibFilesString() . '"';
+    }
+}

src/SPC/builder/extension/swoole.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('swoole')]
+class swoole extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        $arg = '--enable-swoole';
+        if ($this->builder->getLib('openssl')) {
+            $arg .= ' --enable-openssl';
+        } else {
+            $arg .= ' --disable-openssl --without-openssl';
+        }
+        // curl hook is buggy for static php
+        $arg .= ' --disable-swoole-curl';
+        return $arg;
+    }
+}

src/SPC/builder/extension/swow.php

@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('swow')]
+class swow extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        $arg = '--enable-swow';
+        $arg .= $this->builder->getLib('openssl') ? ' --enable-swow-ssl' : ' --disable-swow-ssl';
+        $arg .= $this->builder->getLib('curl') ? ' --enable-swow-curl' : ' --disable-swow-curl';
+        return $arg;
+    }
+}

src/SPC/builder/extension/xml.php

@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\exception\RuntimeException;
+use SPC\util\CustomExt;
+
+#[CustomExt('xml')]
+#[CustomExt('soap')]
+#[CustomExt('xmlreader')]
+#[CustomExt('xmlwriter')]
+#[CustomExt('dom')]
+#[CustomExt('simplexml')]
+class xml extends Extension
+{
+    /**
+     * @throws RuntimeException
+     */
+    public function getUnixConfigureArg(): string
+    {
+        $arg = match ($this->name) {
+            'xml' => '--enable-xml',
+            'soap' => '--enable-soap',
+            'xmlreader' => '--enable-xmlreader',
+            'xmlwriter' => '--enable-xmlwriter',
+            'dom' => '--enable-dom',
+            'simplexml' => '--enable-simplexml',
+            default => throw new RuntimeException('Not accept non-xml extension'),
+        };
+        $arg .= ' --with-libxml="' . BUILD_ROOT_PATH . '" ' .
+            'LIBXML_CFLAGS=-I"' . realpath('include/libxml2') . '" ' .
+            'LIBXML_LIBS="' . $this->getLibFilesString() . '" ';
+        return $arg;
+    }
+}

src/SPC/builder/extension/zip.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('zip')]
+class zip extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        return '--with-zip LIBZIP_CFLAGS=-I"' . BUILD_INCLUDE_PATH . '" ' .
+            'LIBZIP_LIBS="' . $this->getLibFilesString() . '"';
+    }
+}

src/SPC/builder/extension/zlib.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('zlib')]
+class zlib extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        return '--with-zlib ZLIB_CFLAGS=-I"' . BUILD_INCLUDE_PATH . '" ' .
+            'ZLIB_LIBS="' . $this->getLibFilesString() . '"';
+    }
+}

src/SPC/builder/extension/zstd.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('zstd')]
+class zstd extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        return '--with-libzstd';
+    }
+}

src/SPC/builder/linux/LinuxBuilder.php

@@ -0,0 +1,334 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux;
+
+use SPC\builder\BuilderBase;
+use SPC\builder\linux\library\LinuxLibraryBase;
+use SPC\builder\traits\UnixBuilderTrait;
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
+use SPC\util\Patcher;
+
+/**
+ * Linux 系统环境下的构建器
+ */
+class LinuxBuilder extends BuilderBase
+{
+    /** 编译的 Unix 工具集 */
+    use UnixBuilderTrait;
+
+    /** @var string[] Linux 环境下编译依赖的命令 */
+    public const REQUIRED_COMMANDS = ['make', 'bison', 'flex', 'pkg-config', 'git', 'autoconf', 'automake', 'tar', 'unzip', /* 'xz', 好像不需要 */ 'gzip', 'bzip2', 'cmake'];
+
+    /** @var string 使用的 libc */
+    public string $libc;
+
+    /** @var array 特殊架构下的 cflags */
+    public array $tune_c_flags;
+
+    /** @var string pkg-config 环境变量 */
+    public string $pkgconf_env;
+
+    /** @var string 交叉编译变量 */
+    public string $cross_compile_prefix = '';
+
+    public string $note_section = "Je pense, donc je suis\0";
+
+    private bool $phar_patched = false;
+
+    /**
+     * @throws RuntimeException
+     * @throws WrongUsageException
+     */
+    public function __construct(?string $cc = null, ?string $cxx = null, ?string $arch = null)
+    {
+        // 初始化一些默认参数
+        $this->cc = $cc ?? 'musl-gcc';
+        $this->cxx = $cxx ?? 'g++';
+        $this->arch = $arch ?? php_uname('m');
+        $this->gnu_arch = arch2gnu($this->arch);
+        $this->libc = 'musl'; // SystemUtil::selectLibc($this->cc);
+
+        // 根据 CPU 线程数设置编译进程数
+        $this->concurrency = SystemUtil::getCpuCount();
+        // 设置 cflags
+        $this->arch_c_flags = SystemUtil::getArchCFlags($this->cc, $this->arch);
+        $this->arch_cxx_flags = SystemUtil::getArchCFlags($this->cxx, $this->arch);
+        $this->tune_c_flags = SystemUtil::checkCCFlags(SystemUtil::getTuneCFlags($this->arch), $this->cc);
+        // 设置 cmake
+        $this->cmake_toolchain_file = SystemUtil::makeCmakeToolchainFile(
+            os: 'Linux',
+            target_arch: $this->arch,
+            cflags: $this->arch_c_flags,
+            cc: $this->cc,
+            cxx: $this->cxx
+        );
+        // 设置 pkgconfig
+        $this->pkgconf_env = 'PKG_CONFIG_PATH="' . BUILD_LIB_PATH . '/pkgconfig"';
+        // 设置 configure 依赖的环境变量
+        $this->configure_env =
+            $this->pkgconf_env . ' ' .
+            "CC='{$this->cc}' " .
+            "CXX='{$this->cxx}' " .
+            (php_uname('m') === $this->arch ? '' : "CFLAGS='{$this->arch_c_flags}'");
+        // 交叉编译依赖的，TODO
+        if (php_uname('m') !== $this->arch) {
+            $this->cross_compile_prefix = SystemUtil::getCrossCompilePrefix($this->cc, $this->arch);
+            logger()->info('using cross compile prefix: ' . $this->cross_compile_prefix);
+            $this->configure_env .= " CROSS_COMPILE='{$this->cross_compile_prefix}'";
+        }
+
+        $missing = [];
+        foreach (self::REQUIRED_COMMANDS as $cmd) {
+            if (SystemUtil::findCommand($cmd) === null) {
+                $missing[] = $cmd;
+            }
+        }
+        if (!empty($missing)) {
+            throw new WrongUsageException('missing system commands: ' . implode(', ', $missing));
+        }
+
+        // 创立 pkg-config 和放头文件的目录
+        f_mkdir(BUILD_LIB_PATH . '/pkgconfig', recursive: true);
+        f_mkdir(BUILD_INCLUDE_PATH, recursive: true);
+    }
+
+    public function makeAutoconfArgs(string $name, array $libSpecs): string
+    {
+        $ret = '';
+        foreach ($libSpecs as $libName => $arr) {
+            $lib = $this->getLib($libName);
+
+            $arr = $arr ?? [];
+
+            $disableArgs = $arr[0] ?? null;
+            $prefix = $arr[1] ?? null;
+            if ($lib instanceof LinuxLibraryBase) {
+                logger()->info("{$name} \033[32;1mwith\033[0;1m {$libName} support");
+                $ret .= $lib->makeAutoconfEnv($prefix) . ' ';
+            } else {
+                logger()->info("{$name} \033[31;1mwithout\033[0;1m {$libName} support");
+                $ret .= ($disableArgs ?? "--with-{$libName}=no") . ' ';
+            }
+        }
+        return rtrim($ret);
+    }
+
+    /**
+     * @throws RuntimeException
+     * @throws FileSystemException
+     */
+    public function buildPHP(int $build_target = BUILD_TARGET_NONE, bool $with_clean = false, bool $bloat = false)
+    {
+        if (!$bloat) {
+            $extra_libs = implode(' ', $this->getAllStaticLibFiles());
+        } else {
+            logger()->info('bloat linking');
+            $extra_libs = implode(
+                ' ',
+                array_map(
+                    fn ($x) => "-Xcompiler {$x}",
+                    array_filter($this->getAllStaticLibFiles())
+                )
+            );
+        }
+
+        $envs = $this->pkgconf_env . ' ' .
+            "CC='{$this->cc}' " .
+            "CXX='{$this->cxx}' ";
+        $cflags = $this->arch_c_flags;
+        $use_lld = '';
+
+        switch ($this->libc) {
+            case 'musl_wrapper':
+            case 'glibc':
+                $cflags .= ' -static-libgcc -I"' . BUILD_INCLUDE_PATH . '"';
+                break;
+            case 'musl':
+                if (str_ends_with($this->cc, 'clang') && SystemUtil::findCommand('lld')) {
+                    $use_lld = '-Xcompiler -fuse-ld=lld';
+                }
+                break;
+            default:
+                throw new WrongUsageException('libc ' . $this->libc . ' is not implemented yet');
+        }
+
+        $envs = "{$envs} CFLAGS='{$cflags}' LIBS='-ldl -lpthread'";
+
+        Patcher::patchPHPBeforeConfigure($this);
+
+        shell()->cd(SOURCE_PATH . '/php-src')->exec('./buildconf --force');
+
+        Patcher::patchPHPConfigure($this);
+
+        shell()->cd(SOURCE_PATH . '/php-src')
+            ->exec(
+                './configure ' .
+                '--prefix= ' .
+                '--with-valgrind=no ' .
+                '--enable-shared=no ' .
+                '--enable-static=yes ' .
+                "--host={$this->gnu_arch}-unknown-linux " .
+                '--disable-all ' .
+                '--disable-cgi ' .
+                '--disable-phpdbg ' .
+                '--enable-cli ' .
+                '--enable-fpm ' .
+                '--enable-micro=all-static ' .
+                ($this->zts ? '--enable-zts' : '') . ' ' .
+                $this->makeExtensionArgs() . ' ' .
+                $envs
+            );
+
+        $extra_libs .= $this->generateExtraLibs();
+
+        file_put_contents('/tmp/comment', $this->note_section);
+
+        // 清理
+        $this->cleanMake();
+
+        if ($bloat) {
+            logger()->info('bloat linking');
+            $extra_libs = "-Wl,--whole-archive {$extra_libs} -Wl,--no-whole-archive";
+        }
+
+        if (($build_target & BUILD_TARGET_CLI) === BUILD_TARGET_CLI) {
+            logger()->info('building cli');
+            $this->buildCli($extra_libs, $use_lld);
+        }
+        if (($build_target & BUILD_TARGET_FPM) === BUILD_TARGET_FPM) {
+            logger()->info('building fpm');
+            $this->buildFpm($extra_libs, $use_lld);
+        }
+        if (($build_target & BUILD_TARGET_MICRO) === BUILD_TARGET_MICRO) {
+            logger()->info('building micro');
+            $this->buildMicro($extra_libs, $use_lld, $cflags);
+        }
+
+        if (php_uname('m') === $this->arch) {
+            $this->sanityCheck($build_target);
+        }
+
+        if ($this->phar_patched) {
+            shell()->cd(SOURCE_PATH . '/php-src')->exec('patch -p1 -R < sapi/micro/patches/phar.patch');
+        }
+    }
+
+    /**
+     * @throws RuntimeException
+     */
+    public function buildCli(string $extra_libs, string $use_lld): void
+    {
+        shell()->cd(SOURCE_PATH . '/php-src')
+            ->exec('sed -i "s|//lib|/lib|g" Makefile')
+            ->exec(
+                'make -j' . $this->concurrency .
+                ' EXTRA_CFLAGS="-g -Os -fno-ident ' . implode(' ', array_map(fn ($x) => "-Xcompiler {$x}", $this->tune_c_flags)) . '" ' .
+                "EXTRA_LIBS=\"{$extra_libs}\" " .
+                "EXTRA_LDFLAGS_PROGRAM='{$use_lld} -all-static' " .
+                'cli'
+            );
+
+        shell()->cd(SOURCE_PATH . '/php-src/sapi/cli')
+            ->exec("{$this->cross_compile_prefix}objcopy --only-keep-debug php php.debug")
+            ->exec('elfedit --output-osabi linux php')
+            ->exec("{$this->cross_compile_prefix}strip --strip-all php")
+            ->exec("{$this->cross_compile_prefix}objcopy --update-section .comment=/tmp/comment --add-gnu-debuglink=php.debug --remove-section=.note php");
+        $this->deployBinary(BUILD_TARGET_CLI);
+    }
+
+    /**
+     * @throws RuntimeException
+     */
+    public function buildMicro(string $extra_libs, string $use_lld, string $cflags): void
+    {
+        if ($this->getPHPVersionID() < 80000) {
+            throw new RuntimeException('phpmicro only support PHP >= 8.0!');
+        }
+        if ($this->getExt('phar')) {
+            $this->phar_patched = true;
+            try {
+                shell()->cd(SOURCE_PATH . '/php-src')->exec('patch -p1 < sapi/micro/patches/phar.patch');
+            } catch (RuntimeException $e) {
+                logger()->error('failed to patch phat due to patch exit with code ' . $e->getCode());
+                $this->phar_patched = false;
+            }
+        }
+
+        shell()->cd(SOURCE_PATH . '/php-src')
+            ->exec('sed -i "s|//lib|/lib|g" Makefile')
+            ->exec(
+                "make -j{$this->concurrency} " .
+                'EXTRA_CFLAGS=' . quote('-g -Os -fno-ident ' . implode(' ', array_map(fn ($x) => "-Xcompiler {$x}", $this->tune_c_flags))) . ' ' .
+                'EXTRA_LIBS=' . quote($extra_libs) . ' ' .
+                'EXTRA_LDFLAGS_PROGRAM=' . quote("{$cflags} {$use_lld}" . ' -all-static', "'") . ' ' .
+                'micro'
+            );
+
+        shell()->cd(SOURCE_PATH . '/php-src/sapi/micro')->exec("{$this->cross_compile_prefix}strip --strip-all micro.sfx");
+
+        $this->deployBinary(BUILD_TARGET_MICRO);
+    }
+
+    /**
+     * @throws RuntimeException
+     */
+    public function buildFpm(string $extra_libs, string $use_lld): void
+    {
+        shell()->cd(SOURCE_PATH . '/php-src')
+            ->exec('sed -i "s|//lib|/lib|g" Makefile')
+            ->exec(
+                'make -j' . $this->concurrency .
+                ' EXTRA_CFLAGS="-g -Os -fno-ident ' . implode(' ', array_map(fn ($x) => "-Xcompiler {$x}", $this->tune_c_flags)) . '" ' .
+                "EXTRA_LIBS=\"{$extra_libs}\" " .
+                "EXTRA_LDFLAGS_PROGRAM='{$use_lld} -all-static' " .
+                'fpm'
+            );
+
+        shell()->cd(SOURCE_PATH . '/php-src/sapi/fpm')
+            ->exec("{$this->cross_compile_prefix}objcopy --only-keep-debug php-fpm php-fpm.debug")
+            ->exec('elfedit --output-osabi linux php-fpm')
+            ->exec("{$this->cross_compile_prefix}strip --strip-all php-fpm")
+            ->exec("{$this->cross_compile_prefix}objcopy --update-section .comment=/tmp/comment --add-gnu-debuglink=php-fpm.debug --remove-section=.note php-fpm");
+        $this->deployBinary(BUILD_TARGET_FPM);
+    }
+
+    /**
+     * @throws RuntimeException
+     */
+    private function generateExtraLibs(): string
+    {
+        if ($this->libc === 'glibc') {
+            $glibc_libs = [
+                'rt',
+                'm',
+                'c',
+                'pthread',
+                'dl',
+                'nsl',
+                'anl',
+                // 'crypt',
+                'resolv',
+                'util',
+            ];
+            $makefile = file_get_contents(SOURCE_PATH . '/php-src/Makefile');
+            preg_match('/^EXTRA_LIBS\s*=\s*(.*)$/m', $makefile, $matches);
+            if (!$matches) {
+                throw new RuntimeException('failed to find EXTRA_LIBS in Makefile');
+            }
+            $_extra_libs = [];
+            foreach (array_filter(explode(' ', $matches[1])) as $used) {
+                foreach ($glibc_libs as $libName) {
+                    if ("-l{$libName}" === $used && !in_array("-l{$libName}", $_extra_libs, true)) {
+                        array_unshift($_extra_libs, "-l{$libName}");
+                    }
+                }
+            }
+            return ' ' . implode(' ', $_extra_libs);
+        }
+        return '';
+    }
+}

src/SPC/builder/linux/SystemUtil.php

@@ -0,0 +1,241 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux;
+
+use JetBrains\PhpStorm\ArrayShape;
+use SPC\builder\traits\UnixSystemUtilTrait;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
+
+class SystemUtil
+{
+    use UnixSystemUtilTrait;
+
+    /**
+     * 查找并选择编译器命令
+     *
+     * @throws RuntimeException
+     */
+    public static function selectCC(): string
+    {
+        logger()->debug('Choose cc');
+        if (self::findCommand('clang')) {
+            logger()->info('using clang');
+            return 'clang';
+        }
+        if (self::findCommand('gcc')) {
+            logger()->info('using gcc');
+            return 'gcc';
+        }
+        throw new RuntimeException('no supported cc found');
+    }
+
+    /**
+     * 查找并选择编译器命令
+     *
+     * @throws RuntimeException
+     */
+    public static function selectCXX(): string
+    {
+        logger()->debug('Choose cxx');
+        if (self::findCommand('clang++')) {
+            logger()->info('using clang++');
+            return 'clang++';
+        }
+        if (self::findCommand('g++')) {
+            logger()->info('using g++');
+            return 'g++';
+        }
+        return self::selectCC();
+    }
+
+    #[ArrayShape(['dist' => 'mixed|string', 'ver' => 'mixed|string'])]
+    public static function getOSRelease(): array
+    {
+        $ret = [
+            'dist' => 'unknown',
+            'ver' => 'unknown',
+        ];
+        switch (true) {
+            case file_exists('/etc/os-release'):
+                $lines = file('/etc/os-release');
+                foreach ($lines as $line) {
+                    if (preg_match('/^ID=(.*)$/', $line, $matches)) {
+                        $ret['dist'] = $matches[1];
+                    }
+                    if (preg_match('/^VERSION_ID=(.*)$/', $line, $matches)) {
+                        $ret['ver'] = $matches[1];
+                    }
+                }
+                $ret['dist'] = trim($ret['dist'], '"\'');
+                $ret['ver'] = trim($ret['ver'], '"\'');
+                if (strcasecmp($ret['dist'], 'centos') === 0) {
+                    $ret['dist'] = 'redhat';
+                }
+                break;
+            case file_exists('/etc/centos-release'):
+                $lines = file('/etc/centos-release');
+                goto rh;
+            case file_exists('/etc/redhat-release'):
+                $lines = file('/etc/redhat-release');
+                rh:
+                foreach ($lines as $line) {
+                    if (preg_match('/release\s+(\d+(\.\d+)*)/', $line, $matches)) {
+                        $ret['dist'] = 'redhat';
+                        $ret['ver'] = $matches[1];
+                    }
+                }
+                break;
+        }
+        return $ret;
+    }
+
+    public static function getCpuCount(): int
+    {
+        $ncpu = 1;
+
+        if (is_file('/proc/cpuinfo')) {
+            $cpuinfo = file_get_contents('/proc/cpuinfo');
+            preg_match_all('/^processor/m', $cpuinfo, $matches);
+            $ncpu = count($matches[0]);
+        }
+
+        return $ncpu;
+    }
+
+    /**
+     * @throws RuntimeException
+     */
+    public static function getCCType(string $cc): string
+    {
+        return match (true) {
+            str_ends_with($cc, 'c++'), str_ends_with($cc, 'cc'), str_ends_with($cc, 'g++'), str_ends_with($cc, 'gcc') => 'gcc',
+            $cc === 'clang++', $cc === 'clang', str_starts_with($cc, 'musl-clang') => 'clang',
+            default => throw new RuntimeException("unknown cc type: {$cc}"),
+        };
+    }
+
+    /**
+     * @throws RuntimeException
+     */
+    public static function getArchCFlags(string $cc, string $arch): string
+    {
+        if (php_uname('m') === $arch) {
+            return '';
+        }
+        return match (static::getCCType($cc)) {
+            'clang' => match ($arch) {
+                'x86_64' => '--target=x86_64-unknown-linux',
+                'arm64', 'aarch64' => '--target=arm64-unknown-linux',
+                default => throw new WrongUsageException('unsupported arch: ' . $arch),
+            },
+            'gcc' => '',
+            default => throw new WrongUsageException('cc compiler ' . $cc . ' is not supported'),
+        };
+    }
+
+    /**
+     * @throws RuntimeException
+     */
+    public static function getTuneCFlags(string $arch): array
+    {
+        return match ($arch) {
+            'x86_64' => [
+                '-march=corei7',
+                '-mtune=core-avx2',
+            ],
+            'arm64', 'aarch64' => [],
+            default => throw new RuntimeException('unsupported arch: ' . $arch),
+        };
+    }
+
+    public static function checkCCFlags(array $flags, string $cc): array
+    {
+        return array_filter($flags, fn ($flag) => static::checkCCFlag($flag, $cc));
+    }
+
+    public static function checkCCFlag(string $flag, string $cc): string
+    {
+        [$ret] = shell()->execWithResult("echo | {$cc} -E -x c - {$flag}");
+        if ($ret != 0) {
+            return '';
+        }
+        return $flag;
+    }
+
+    /**
+     * @throws RuntimeException
+     */
+    public static function getCrossCompilePrefix(string $cc, string $arch): string
+    {
+        return match (static::getCCType($cc)) {
+            // guessing clang toolchains
+            'clang' => match ($arch) {
+                'x86_64' => 'x86_64-linux-gnu-',
+                'arm64', 'aarch64' => 'aarch64-linux-gnu-',
+                default => throw new RuntimeException('unsupported arch: ' . $arch),
+            },
+            // remove gcc postfix
+            'gcc' => str_replace('-cc', '', str_replace('-gcc', '', $cc)) . '-',
+            default => throw new RuntimeException('unsupported cc'),
+        };
+    }
+
+    public static function findStaticLib(string $name): ?array
+    {
+        $paths = getenv('LIBPATH');
+        if (!$paths) {
+            $paths = '/lib:/lib64:/usr/lib:/usr/lib64:/usr/local/lib:/usr/local/lib64';
+        }
+        foreach (explode(':', $paths) as $path) {
+            if (file_exists("{$path}/{$name}")) {
+                return ["{$path}", "{$name}"];
+            }
+        }
+        return null;
+    }
+
+    public static function findStaticLibs(array $names): ?array
+    {
+        $ret = [];
+        foreach ($names as $name) {
+            $path = static::findStaticLib($name);
+            if (!$path) {
+                logger()->warning("static library {$name} not found");
+                return null;
+            }
+            $ret[] = $path;
+        }
+        return $ret;
+    }
+
+    public static function findHeader(string $name): ?array
+    {
+        $paths = getenv('INCLUDEPATH');
+        if (!$paths) {
+            $paths = '/include:/usr/include:/usr/local/include';
+        }
+        foreach (explode(':', $paths) as $path) {
+            if (file_exists("{$path}/{$name}") || is_dir("{$path}/{$name}")) {
+                return ["{$path}", "{$name}"];
+            }
+        }
+        return null;
+    }
+
+    public static function findHeaders(array $names): ?array
+    {
+        $ret = [];
+        foreach ($names as $name) {
+            $path = static::findHeader($name);
+            if (!$path) {
+                logger()->warning("header {$name} not found");
+                return null;
+            }
+            $ret[] = $path;
+        }
+        return $ret;
+    }
+}

src/SPC/builder/linux/library/LinuxLibraryBase.php

@@ -0,0 +1,78 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+use SPC\builder\BuilderBase;
+use SPC\builder\LibraryBase;
+use SPC\builder\linux\LinuxBuilder;
+use SPC\builder\traits\UnixLibraryTrait;
+use SPC\exception\RuntimeException;
+
+abstract class LinuxLibraryBase extends LibraryBase
+{
+    use UnixLibraryTrait;
+
+    protected array $static_libs = [];
+
+    protected array $headers;
+
+    protected array $pkgconfs;
+
+    /**
+     * 依赖的名字及是否可选，例如：curl => true，代表依赖 curl 但可选
+     */
+    protected array $dep_names;
+
+    public function __construct(protected LinuxBuilder $builder)
+    {
+        parent::__construct();
+    }
+
+    public function getBuilder(): BuilderBase
+    {
+        return $this->builder;
+    }
+
+    /**
+     * @throws RuntimeException
+     */
+    public function tryBuild(bool $force_build = false): int
+    {
+        // 传入 true，表明直接编译
+        if ($force_build) {
+            logger()->info('Building required library [' . static::NAME . ']');
+            $this->build();
+            return BUILD_STATUS_OK;
+        }
+
+        // 看看这些库是不是存在，如果不存在，则调用编译并返回结果状态
+        foreach ($this->getStaticLibs() as $name) {
+            if (!file_exists(BUILD_LIB_PATH . "/{$name}")) {
+                $this->tryBuild(true);
+                return BUILD_STATUS_OK;
+            }
+        }
+        // 头文件同理
+        foreach ($this->getHeaders() as $name) {
+            if (!file_exists(BUILD_INCLUDE_PATH . "/{$name}")) {
+                $this->tryBuild(true);
+                return BUILD_STATUS_OK;
+            }
+        }
+        // 到这里说明所有的文件都存在，就跳过编译
+        return BUILD_STATUS_ALREADY;
+    }
+
+    protected function makeFakePkgconfs()
+    {
+        $workspace = BUILD_ROOT_PATH;
+        if ($workspace === '/') {
+            $workspace = '';
+        }
+        foreach ($this->pkgconfs as $name => $content) {
+            file_put_contents(BUILD_LIB_PATH . "/pkgconfig/{$name}", "prefix={$workspace}\n" . $content);
+        }
+    }
+}

src/SPC/builder/linux/library/brotli.php

@@ -0,0 +1,59 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+use SPC\exception\RuntimeException;
+
+class brotli extends LinuxLibraryBase
+{
+    public const NAME = 'brotli';
+
+    /**
+     * @throws RuntimeException
+     */
+    public function build()
+    {
+        [$lib, $include, $destdir] = SEPARATED_PATH;
+        // 清理旧的编译文件
+        shell()->cd($this->source_dir)
+            ->exec('rm -rf build')
+            ->exec('mkdir -p build');
+        // 使用 cmake 编译
+        shell()->cd($this->source_dir . '/build')
+            ->exec(
+                $this->builder->configure_env . ' cmake ' .
+                '-DCMAKE_BUILD_TYPE=Release ' .
+                '-DBUILD_SHARED_LIBS=OFF ' .
+                '-DCMAKE_INSTALL_PREFIX=/ ' .
+                "-DCMAKE_INSTALL_LIBDIR={$lib} " .
+                "-DCMAKE_INSTALL_INCLUDEDIR={$include} " .
+                "-DCMAKE_TOOLCHAIN_FILE={$this->builder->cmake_toolchain_file} " .
+                '..'
+            )
+            ->exec("cmake --build . -j {$this->builder->concurrency} --target brotlicommon-static")
+            ->exec("cmake --build . -j {$this->builder->concurrency} --target brotlidec-static")
+            ->exec("cmake --build . -j {$this->builder->concurrency} --target brotlienc-static")
+            ->exec('cp libbrotlidec-static.a ' . BUILD_LIB_PATH)
+            ->exec('cp libbrotlienc-static.a ' . BUILD_LIB_PATH)
+            ->exec('cp libbrotlicommon-static.a ' . BUILD_LIB_PATH)
+            ->exec('cp -r ../c/include/brotli ' . BUILD_INCLUDE_PATH);
+    }
+}

src/SPC/builder/linux/library/bzip2.php

@@ -0,0 +1,43 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+use SPC\exception\RuntimeException;
+
+class bzip2 extends LinuxLibraryBase
+{
+    public const NAME = 'bzip2';
+
+    protected array $dep_names = [];
+
+    /**
+     * @throws RuntimeException
+     */
+    public function build()
+    {
+        shell()
+            ->cd($this->source_dir)
+            ->exec("make {$this->builder->configure_env} PREFIX='" . BUILD_ROOT_PATH . "' clean")
+            ->exec("make -j{$this->builder->concurrency} {$this->builder->configure_env} PREFIX='" . BUILD_ROOT_PATH . "' libbz2.a")
+            ->exec('cp libbz2.a ' . BUILD_LIB_PATH)
+            ->exec('cp bzlib.h ' . BUILD_INCLUDE_PATH);
+    }
+}

src/SPC/builder/linux/library/curl.php

@@ -0,0 +1,160 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+use SPC\exception\RuntimeException;
+
+class curl extends LinuxLibraryBase
+{
+    public const NAME = 'curl';
+
+    protected array $static_libs = ['libcurl.a'];
+
+    protected array $headers = ['curl'];
+
+    protected array $pkgconfs = [
+        'libcurl.pc' => <<<'EOF'
+exec_prefix=${prefix}
+libdir=${exec_prefix}/lib
+includedir=${prefix}/include
+supported_protocols="DICT FILE FTP FTPS GOPHER GOPHERS HTTP HTTPS IMAP IMAPS MQTT POP3 POP3S RTSP SCP SFTP SMB SMBS SMTP SMTPS TELNET TFTP"
+supported_features="AsynchDNS GSS-API HSTS HTTP2 HTTPS-proxy IDN IPv6 Kerberos Largefile NTLM NTLM_WB PSL SPNEGO SSL TLS-SRP UnixSockets alt-svc brotli libz zstd"
+
+Name: libcurl
+URL: https://curl.se/
+Description: Library to transfer files with ftp, http, etc.
+Version: 7.83.0
+Libs: -L${libdir} -lcurl
+Libs.private: -lnghttp2 -lidn2 -lssh2 -lssh2 -lpsl -lssl -lcrypto -lssl -lcrypto -lgssapi_krb5 -lzstd -lbrotlidec -lz
+Cflags: -I${includedir}
+EOF
+    ];
+
+    protected array $dep_names = [
+        'zlib' => false,
+        'libssh2' => true,
+        'brotli' => true,
+        'nghttp2' => true,
+        'zstd' => true,
+        'openssl' => true,
+        'idn2' => true,
+        'psl' => true,
+    ];
+
+    public function getStaticLibFiles(string $style = 'autoconf', bool $recursive = true): string
+    {
+        $libs = parent::getStaticLibFiles($style, $recursive);
+        if ($this->builder->getLib('openssl')) {
+            $libs .= ' -ldl -lpthread';
+        }
+        return $libs;
+    }
+
+    /**
+     * @throws RuntimeException
+     */
+    public function build()
+    {
+        $extra = '';
+        // lib:openssl
+        $openssl = $this->builder->getLib('openssl');
+        $use_openssl = $openssl instanceof LinuxLibraryBase ? 'ON' : 'OFF';
+        $extra .= "-DCURL_USE_OPENSSL={$use_openssl} -DCURL_ENABLE_SSL={$use_openssl} ";
+        // lib:zlib
+        $zlib = $this->builder->getLib('zlib');
+        if ($zlib instanceof LinuxLibraryBase) {
+            $extra .= '-DZLIB_LIBRARY="' . $zlib->getStaticLibFiles(style: 'cmake') . '" ' .
+                '-DZLIB_INCLUDE_DIR="' . BUILD_INCLUDE_PATH . '" ';
+        }
+        // lib:libssh2
+        $libssh2 = $this->builder->getLib('libssh2');
+        if ($libssh2 instanceof LinuxLibraryBase) {
+            $extra .= '-DLIBSSH2_LIBRARY="' . $libssh2->getStaticLibFiles(style: 'cmake') . '" ' .
+                '-DLIBSSH2_INCLUDE_DIR="' . BUILD_INCLUDE_PATH . '" ';
+        } else {
+            $extra .= '-DCURL_USE_LIBSSH2=OFF ';
+        }
+        // lib:brotli
+        $brotli = $this->builder->getLib('brotli');
+        if ($brotli) {
+            $extra .= '-DCURL_BROTLI=ON ' .
+                '-DBROTLIDEC_LIBRARY="' . realpath(BUILD_LIB_PATH . '/libbrotlidec-static.a') . ';' . realpath(BUILD_LIB_PATH . '/libbrotlicommon-static.a') . '" ' .
+                '-DBROTLICOMMON_LIBRARY="' . realpath(BUILD_LIB_PATH . '/libbrotlicommon-static.a') . '" ' .
+                '-DBROTLI_INCLUDE_DIR="' . BUILD_INCLUDE_PATH . '" ';
+        } else {
+            $extra .= '-DCURL_BROTLI=OFF ';
+        }
+        // lib:nghttp2
+        $nghttp2 = $this->builder->getLib('nghttp2');
+        if ($nghttp2 instanceof LinuxLibraryBase) {
+            $extra .= '-DUSE_NGHTTP2=ON ' .
+                '-DNGHTTP2_LIBRARY="' . $nghttp2->getStaticLibFiles(style: 'cmake') . '" ' .
+                '-DNGHTTP2_INCLUDE_DIR="' . BUILD_INCLUDE_PATH . '" ';
+        } else {
+            $extra .= '-DUSE_NGHTTP2=OFF ';
+        }
+        // lib:ldap
+        $ldap = $this->builder->getLib('ldap');
+        if ($ldap instanceof LinuxLibraryBase) {
+            // $extra .= '-DCURL_DISABLE_LDAP=OFF ';
+            // TODO: LDAP support
+            throw new RuntimeException('LDAP support is not implemented yet');
+        }
+        $extra .= '-DCURL_DISABLE_LDAP=ON ';
+        // lib:zstd
+        $zstd = $this->builder->getLib('zstd');
+        if ($zstd instanceof LinuxLibraryBase) {
+            $extra .= '-DCURL_ZSTD=ON ' .
+                '-DZstd_LIBRARY="' . $zstd->getStaticLibFiles(style: 'cmake') . '" ' .
+                '-DZstd_INCLUDE_DIR="' . BUILD_INCLUDE_PATH . '" ';
+        } else {
+            $extra .= '-DCURL_ZSTD=OFF ';
+        }
+        // lib:idn2
+        $idn2 = $this->builder->getLib('idn2');
+        $extra .= $idn2 instanceof LinuxLibraryBase ? '-DUSE_LIBIDN2=ON ' : '-DUSE_LIBIDN2=OFF ';
+        // lib:psl
+        $libpsl = $this->builder->getLib('psl');
+        $extra .= $libpsl instanceof LinuxLibraryBase ? '-DCURL_USE_LIBPSL=ON ' : '-DCURL_USE_LIBPSL=OFF ';
+
+        [$lib, $include, $destdir] = SEPARATED_PATH;
+        // compile！
+        shell()
+            ->cd($this->source_dir)
+            ->exec('rm -rf build')
+            ->exec('mkdir -p build')
+            ->cd($this->source_dir . '/build')
+            ->exec("{$this->builder->configure_env} cmake " .
+                '-DCMAKE_BUILD_TYPE=Release ' .
+                '-DBUILD_SHARED_LIBS=OFF ' .
+                '-DBUILD_CURL_EXE=OFF ' .
+                $extra .
+                "-DCMAKE_INSTALL_PREFIX={$destdir} " .
+                "-DCMAKE_INSTALL_LIBDIR={$lib} " .
+                "-DCMAKE_INSTALL_INCLUDEDIR={$include} " .
+                "-DCMAKE_TOOLCHAIN_FILE={$this->builder->cmake_toolchain_file} " .
+                '..')
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec("make install DESTDIR='{$destdir}'");
+        shell()->cd(BUILD_LIB_PATH . '/cmake/CURL/')
+            ->exec("sed -ie 's|\"/lib/libcurl.a\"|\"" . BUILD_LIB_PATH . "/libcurl.a\"|g' CURLTargets-release.cmake");
+    }
+}

src/SPC/builder/linux/library/gmp.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+/**
+ * gmp is a template library class for unix
+ */
+class gmp extends LinuxLibraryBase
+{
+    public const NAME = 'gmp';
+
+    protected function build()
+    {
+        [,,$destdir] = SEPARATED_PATH;
+
+        shell()->cd($this->source_dir)
+            ->exec(
+                "{$this->builder->configure_env} ./configure " .
+                '--enable-static --disable-shared ' .
+                '--prefix='
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec("make install DESTDIR={$destdir}");
+    }
+}

src/SPC/builder/linux/library/libiconv.php

@@ -0,0 +1,49 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+use SPC\exception\RuntimeException;
+
+class libiconv extends LinuxLibraryBase
+{
+    public const NAME = 'libiconv';
+
+    protected array $dep_names = [];
+
+    /**
+     * @throws RuntimeException
+     */
+    public function build()
+    {
+        [,,$destdir] = SEPARATED_PATH;
+
+        shell()->cd($this->source_dir)
+            ->exec(
+                "{$this->builder->configure_env} ./configure " .
+                '--enable-static ' .
+                '--disable-shared ' .
+                '--prefix='
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec('make install DESTDIR=' . $destdir);
+    }
+}

src/SPC/builder/linux/library/libpng.php

@@ -0,0 +1,65 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\util\Patcher;
+
+class libpng extends LinuxLibraryBase
+{
+    public const NAME = 'libpng';
+
+    /**
+     * @throws RuntimeException
+     * @throws FileSystemException
+     */
+    public function build()
+    {
+        // 不同架构的专属优化
+        $optimizations = match ($this->builder->arch) {
+            'x86_64' => '--enable-intel-sse ',
+            'arm64' => '--enable-arm-neon ',
+            default => '',
+        };
+
+        // patch configure
+        Patcher::patchUnixLibpng();
+
+        shell()->cd($this->source_dir)
+            ->exec('chmod +x ./configure')
+            ->exec(
+                "{$this->builder->configure_env} ./configure " .
+                "--host={$this->builder->gnu_arch}-unknown-linux " .
+                '--disable-shared ' .
+                '--enable-static ' .
+                '--enable-hardware-optimizations ' .
+                '--with-zlib-prefix=' . BUILD_ROOT_PATH . ' ' .
+                $optimizations .
+                '--prefix='
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency} DEFAULT_INCLUDES='-I. -I" . BUILD_INCLUDE_PATH . "' LIBS= libpng16.la")
+            ->exec('make install-libLTLIBRARIES install-data-am DESTDIR=' . BUILD_ROOT_PATH)
+            ->cd(BUILD_LIB_PATH)
+            ->exec('ln -sf libpng16.a libpng.a');
+    }
+}

src/SPC/builder/linux/library/libssh2.php

@@ -0,0 +1,60 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+use SPC\exception\RuntimeException;
+
+class libssh2 extends LinuxLibraryBase
+{
+    public const NAME = 'libssh2';
+
+    /**
+     * @throws RuntimeException
+     */
+    public function build()
+    {
+        // lib:zlib
+        $enable_zlib = $this->builder->getLib('zlib') !== null ? 'ON' : 'OFF';
+
+        [$lib, $include, $destdir] = SEPARATED_PATH;
+
+        shell()->cd($this->source_dir)
+            ->exec('rm -rf build')
+            ->exec('mkdir -p build')
+            ->cd($this->source_dir . '/build')
+            ->exec(
+                "{$this->builder->configure_env} " . ' cmake ' .
+                // '--debug-find ' .
+                '-DCMAKE_BUILD_TYPE=Release ' .
+                '-DBUILD_SHARED_LIBS=OFF ' .
+                '-DBUILD_EXAMPLES=OFF ' .
+                '-DBUILD_TESTING=OFF ' .
+                "-DENABLE_ZLIB_COMPRESSION={$enable_zlib} " .
+                '-DCMAKE_INSTALL_PREFIX=/ ' .
+                "-DCMAKE_INSTALL_LIBDIR={$lib} " .
+                "-DCMAKE_INSTALL_INCLUDEDIR={$include} " .
+                "-DCMAKE_TOOLCHAIN_FILE={$this->builder->cmake_toolchain_file} " .
+                '..'
+            )
+            ->exec("cmake --build . -j {$this->builder->concurrency} --target libssh2")
+            ->exec('make install DESTDIR="' . $destdir . '"');
+    }
+}

src/SPC/builder/linux/library/libxml2.php

@@ -0,0 +1,76 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+use SPC\exception\RuntimeException;
+use SPC\store\FileSystem;
+
+class libxml2 extends LinuxLibraryBase
+{
+    public const NAME = 'libxml2';
+
+    /**
+     * @throws RuntimeException
+     */
+    public function build()
+    {
+        $enable_zlib = $this->builder->getLib('zlib') ? 'ON' : 'OFF';
+        $enable_icu = $this->builder->getLib('icu') ? 'ON' : 'OFF';
+        $enable_xz = $this->builder->getLib('xz') ? 'ON' : 'OFF';
+
+        [$lib, $include, $destdir] = SEPARATED_PATH;
+
+        shell()->cd($this->source_dir)
+            ->exec('rm -rf build')
+            ->exec('mkdir -p build')
+            ->cd($this->source_dir . '/build')
+            ->exec(
+                "{$this->builder->configure_env} " . ' cmake ' .
+                // '--debug-find ' .
+                '-DCMAKE_BUILD_TYPE=Release ' .
+                '-DBUILD_SHARED_LIBS=OFF ' .
+                '-DLIBXML2_WITH_ICONV=ON ' .
+                '-DIconv_IS_BUILT_IN=OFF ' .
+                "-DLIBXML2_WITH_ZLIB={$enable_zlib} " .
+                "-DLIBXML2_WITH_ICU={$enable_icu} " .
+                "-DLIBXML2_WITH_LZMA={$enable_xz} " .
+                '-DLIBXML2_WITH_PYTHON=OFF ' .
+                '-DLIBXML2_WITH_PROGRAMS=OFF ' .
+                '-DLIBXML2_WITH_TESTS=OFF ' .
+                '-DCMAKE_INSTALL_PREFIX=/ ' .
+                "-DCMAKE_INSTALL_LIBDIR={$lib} " .
+                "-DCMAKE_INSTALL_INCLUDEDIR={$include} " .
+                "-DCMAKE_TOOLCHAIN_FILE={$this->builder->cmake_toolchain_file} " .
+                '..'
+            )
+            ->exec("cmake --build . -j {$this->builder->concurrency}")
+            ->exec('make install DESTDIR="' . $destdir . '"');
+
+        if (is_dir(BUILD_INCLUDE_PATH . '/libxml2/libxml')) {
+            if (is_dir(BUILD_INCLUDE_PATH . '/libxml')) {
+                shell()->exec('rm -rf "' . BUILD_INCLUDE_PATH . '/libxml"');
+            }
+            $path = FileSystem::convertPath(BUILD_INCLUDE_PATH . '/libxml2/libxml');
+            $dst_path = FileSystem::convertPath(BUILD_INCLUDE_PATH . '/');
+            shell()->exec('mv "' . $path . '" "' . $dst_path . '"');
+        }
+    }
+}

src/SPC/builder/linux/library/libyaml.php

@@ -0,0 +1,93 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+use SPC\exception\RuntimeException;
+
+class libyaml extends LinuxLibraryBase
+{
+    public const NAME = 'libyaml';
+
+    /**
+     * @throws RuntimeException
+     */
+    public function build()
+    {
+        // prepare cmake/config.h.in
+        if (!is_file(SOURCE_PATH . '/libyaml/cmake/config.h.in')) {
+            f_mkdir(SOURCE_PATH . '/libyaml/cmake');
+            file_put_contents(
+                SOURCE_PATH . '/libyaml/cmake/config.h.in',
+                <<<'EOF'
+#define YAML_VERSION_MAJOR @YAML_VERSION_MAJOR@
+#define YAML_VERSION_MINOR @YAML_VERSION_MINOR@
+#define YAML_VERSION_PATCH @YAML_VERSION_PATCH@
+#define YAML_VERSION_STRING "@YAML_VERSION_STRING@"
+EOF
+            );
+        }
+
+        // prepare yamlConfig.cmake.in
+        if (!is_file(SOURCE_PATH . '/libyaml/yamlConfig.cmake.in')) {
+            file_put_contents(
+                SOURCE_PATH . '/libyaml/yamlConfig.cmake.in',
+                <<<'EOF'
+# Config file for the yaml library.
+#
+# It defines the following variables:
+#   yaml_LIBRARIES    - libraries to link against
+
+@PACKAGE_INIT@
+
+set_and_check(yaml_TARGETS "@PACKAGE_CONFIG_DIR_CONFIG@/yamlTargets.cmake")
+
+if(NOT yaml_TARGETS_IMPORTED)
+  set(yaml_TARGETS_IMPORTED 1)
+  include(${yaml_TARGETS})
+endif()
+
+set(yaml_LIBRARIES yaml)
+
+EOF
+            );
+        }
+
+        [$lib, $include, $destdir] = SEPARATED_PATH;
+
+        shell()
+            ->cd($this->source_dir)
+            ->exec('rm -rf build')
+            ->exec('mkdir -p build')
+            ->cd($this->source_dir . '/build')
+            ->exec("{$this->builder->configure_env} cmake " .
+                // '--debug-find ' .
+                '-DCMAKE_BUILD_TYPE=Release ' .
+                '-DBUILD_TESTING=OFF ' .
+                '-DBUILD_SHARED_LIBS=OFF ' .
+                '-DCMAKE_INSTALL_PREFIX=/ ' .
+                "-DCMAKE_INSTALL_LIBDIR={$lib} " .
+                "-DCMAKE_INSTALL_INCLUDEDIR={$include} " .
+                "-DCMAKE_TOOLCHAIN_FILE={$this->builder->cmake_toolchain_file} " .
+                '..')
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec("make install DESTDIR={$destdir}");
+    }
+}

src/SPC/builder/linux/library/libzip.php

@@ -0,0 +1,106 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+
+class libzip extends LinuxLibraryBase
+{
+    public const NAME = 'libzip';
+
+    /**
+     * @throws FileSystemException|RuntimeException
+     */
+    public function build()
+    {
+        $extra = '';
+        // lib:zlib
+        $zlib = $this->builder->getLib('zlib');
+        if ($zlib instanceof LinuxLibraryBase) {
+            $extra .= '-DZLIB_LIBRARY="' . $zlib->getStaticLibFiles(style: 'cmake') . '" ' .
+                '-DZLIB_INCLUDE_DIR=' . BUILD_INCLUDE_PATH . ' ';
+        }
+        // lib:bzip2
+        $libbzip2 = $this->builder->getLib('bzip2');
+        if ($libbzip2 instanceof LinuxLibraryBase) {
+            $extra .= '-DENABLE_BZIP2=ON ' .
+                '-DBZIP2_LIBRARIES="' . $libbzip2->getStaticLibFiles(style: 'cmake') . '" ' .
+                '-DBZIP2_INCLUDE_DIR=' . BUILD_INCLUDE_PATH . ' ';
+        } else {
+            $extra .= '-DENABLE_BZIP2=OFF ';
+        }
+        // lib:xz
+        $xz = $this->builder->getLib('xz');
+        if ($xz instanceof LinuxLibraryBase) {
+            $extra .= '-DENABLE_LZMA=ON ' .
+                '-DLIBLZMA_LIBRARY="' . $xz->getStaticLibFiles(style: 'cmake') . '" ' .
+                '-DLIBLZMA_INCLUDE_DIR=' . BUILD_INCLUDE_PATH . ' ';
+        } else {
+            $extra .= '-DENABLE_LZMA=OFF ';
+        }
+        // lib:zstd
+        $libzstd = $this->builder->getLib('zstd');
+        if ($libzstd instanceof LinuxLibraryBase) {
+            $extra .= '-DENABLE_ZSTD=ON ' .
+                '-DZstd_LIBRARY="' . $libzstd->getStaticLibFiles(style: 'cmake') . '" ' .
+                '-DZstd_INCLUDE_DIR="' . BUILD_INCLUDE_PATH . '" ';
+        } else {
+            $extra .= '-DENABLE_ZSTD=OFF ';
+        }
+        // lib:openssl
+        $libopenssl = $this->builder->getLib('openssl');
+        if ($libopenssl instanceof LinuxLibraryBase) {
+            $extra .= '-DENABLE_OPENSSL=ON ' .
+                '-DOpenSSL_LIBRARY="' . $libopenssl->getStaticLibFiles(style: 'cmake') . '" ' .
+                '-DOpenSSL_INCLUDE_DIR="' . BUILD_INCLUDE_PATH . '" ';
+        } else {
+            $extra .= '-DENABLE_OPENSSL=OFF ';
+        }
+
+        [$lib, $include, $destdir] = SEPARATED_PATH;
+
+        shell()
+            ->cd($this->source_dir)
+            ->exec('rm -rf build')
+            ->exec('mkdir -p build')
+            ->cd($this->source_dir . '/build')
+            ->exec(
+                $this->builder->configure_env . ' cmake ' .
+                '-DCMAKE_BUILD_TYPE=Release ' .
+                '-DENABLE_GNUTLS=OFF ' .
+                '-DENABLE_MBEDTLS=OFF ' .
+                '-DBUILD_SHARED_LIBS=OFF ' .
+                '-DBUILD_DOC=OFF ' .
+                '-DBUILD_EXAMPLES=OFF ' .
+                '-DBUILD_REGRESS=OFF ' .
+                '-DBUILD_TOOLS=OFF ' .
+                $extra .
+                '-DCMAKE_INSTALL_PREFIX=/ ' .
+                "-DCMAKE_INSTALL_LIBDIR={$lib} " .
+                "-DCMAKE_INSTALL_INCLUDEDIR={$include} " .
+                "-DCMAKE_TOOLCHAIN_FILE={$this->builder->cmake_toolchain_file} " .
+                '..'
+            )
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec('make install DESTDIR=' . $destdir);
+    }
+}

src/SPC/builder/linux/library/nghttp2.php

@@ -0,0 +1,102 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+use SPC\exception\RuntimeException;
+
+class nghttp2 extends LinuxLibraryBase
+{
+    public const NAME = 'nghttp2';
+
+    protected array $static_libs = ['libnghttp2.a'];
+
+    protected array $headers = ['nghttp2'];
+
+    protected array $pkgconfs = [
+        'libnghttp2.pc' => <<<'EOF'
+exec_prefix=${prefix}
+libdir=${exec_prefix}/lib
+includedir=${prefix}/include
+
+Name: libnghttp2
+Description: HTTP/2 C library
+URL: https://github.com/tatsuhiro-t/nghttp2
+Version: 1.47.0
+Libs: -L${libdir} -lnghttp2
+Cflags: -I${includedir}
+EOF
+    ];
+
+    protected array $dep_names = [
+        'zlib' => false,
+        'openssl' => false,
+        'libxml2' => true,
+        'libev' => true,
+        'libcares' => true,
+        'libngtcp2' => true,
+        'libnghttp3' => true,
+        'libbpf' => true,
+        'libevent-openssl' => true,
+        'jansson' => true,
+        'jemalloc' => true,
+        'systemd' => true,
+        'cunit' => true,
+    ];
+
+    /**
+     * @throws RuntimeException
+     */
+    public function build()
+    {
+        $args = $this->builder->makeAutoconfArgs(static::NAME, [
+            'zlib' => null,
+            'openssl' => null,
+            'libxml2' => null,
+            'libev' => null,
+            'libcares' => null,
+            'libngtcp2' => null,
+            'libnghttp3' => null,
+            'libbpf' => null,
+            'libevent-openssl' => null,
+            'jansson' => null,
+            'jemalloc' => null,
+            'systemd' => null,
+            'cunit' => null,
+        ]);
+
+        [,,$destdir] = SEPARATED_PATH;
+
+        shell()->cd($this->source_dir)
+            ->exec(
+                "{$this->builder->configure_env} ./configure " .
+                '--enable-static ' .
+                '--disable-shared ' .
+                "--host={$this->builder->gnu_arch}-unknown-linux " .
+                '--enable-lib-only ' .
+                '--with-boost=no ' .
+                $args . ' ' .
+                '--prefix='
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec("make install DESTDIR={$destdir}");
+    }
+}

src/SPC/builder/linux/library/onig.php

@@ -0,0 +1,48 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+use SPC\exception\RuntimeException;
+
+class onig extends LinuxLibraryBase
+{
+    public const NAME = 'onig';
+
+    /**
+     * @throws RuntimeException
+     */
+    public function build()
+    {
+        [,,$destdir] = SEPARATED_PATH;
+
+        shell()->cd($this->source_dir)
+            ->exec(
+                "{$this->builder->configure_env} ./configure " .
+                '--enable-static ' .
+                '--disable-shared ' .
+                "--host={$this->builder->arch}-unknown-linux " .
+                '--prefix='
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec("make install DESTDIR={$destdir}");
+    }
+}

src/SPC/builder/linux/library/openssl.php

@@ -0,0 +1,77 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+use SPC\builder\linux\SystemUtil;
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+
+class openssl extends LinuxLibraryBase
+{
+    public const NAME = 'openssl';
+
+    /**
+     * @throws RuntimeException
+     * @throws FileSystemException
+     */
+    public function build()
+    {
+        [$lib,$include,$destdir] = SEPARATED_PATH;
+
+        $extra = '';
+        $ex_lib = '-ldl -pthread';
+
+        $env = $this->builder->pkgconf_env . " CFLAGS='{$this->builder->arch_c_flags}'";
+        $env .= " CC='{$this->builder->cc} -static -idirafter " . BUILD_INCLUDE_PATH .
+            ' -idirafter /usr/include/ ' .
+            ' -idirafter /usr/include/' . $this->builder->arch . '-linux-gnu/ ' .
+            "' ";
+        // lib:zlib
+        $zlib = $this->builder->getLib('zlib');
+        if ($zlib instanceof LinuxLibraryBase) {
+            $extra = 'zlib';
+            $ex_lib = trim($zlib->getStaticLibFiles() . ' ' . $ex_lib);
+            $zlib_extra =
+                '--with-zlib-include=' . BUILD_INCLUDE_PATH . ' ' .
+                '--with-zlib-lib=' . BUILD_LIB_PATH . ' ';
+        } else {
+            $zlib_extra = '';
+        }
+
+        $ex_lib = trim($ex_lib);
+
+        $clang_postfix = SystemUtil::getCCType($this->builder->cc) === 'clang' ? '-clang' : '';
+
+        shell()->cd($this->source_dir)
+            ->exec(
+                "{$this->builder->configure_env} {$env} ./Configure no-shared {$extra} " .
+                '--prefix=/ ' .
+                '--libdir=lib ' .
+                '-static ' .
+                "{$zlib_extra}" .
+                'no-legacy ' .
+                "linux-{$this->builder->arch}{$clang_postfix}"
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency} CNF_EX_LIBS=\"{$ex_lib}\"")
+            ->exec("make install_sw DESTDIR={$destdir}");
+    }
+}

src/SPC/builder/linux/library/sqlite.php

@@ -0,0 +1,47 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+use SPC\exception\RuntimeException;
+
+class sqlite extends LinuxLibraryBase
+{
+    public const NAME = 'sqlite';
+
+    /**
+     * @throws RuntimeException
+     */
+    public function build()
+    {
+        [,,$destdir] = SEPARATED_PATH;
+
+        shell()->cd($this->source_dir)
+            ->exec(
+                "{$this->builder->configure_env} ./configure " .
+                '--enable-static ' .
+                '--disable-shared ' .
+                '--prefix='
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec("make install DESTDIR={$destdir}");
+    }
+}

src/SPC/builder/linux/library/xz.php

@@ -0,0 +1,56 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+use SPC\exception\RuntimeException;
+
+class xz extends LinuxLibraryBase
+{
+    public const NAME = 'xz';
+
+    /**
+     * @throws RuntimeException
+     */
+    public function build()
+    {
+        [,,$destdir] = SEPARATED_PATH;
+
+        shell()->cd($this->source_dir)
+            // ->exec('autoreconf -i --force')
+            ->exec(
+                "{$this->builder->configure_env} ./configure " .
+                '--enable-static ' .
+                '--disable-shared ' .
+                "--host={$this->builder->gnu_arch}-unknown-linux " .
+                '--disable-xz ' .
+                '--disable-xzdec ' .
+                '--disable-lzmadec ' .
+                '--disable-lzmainfo ' .
+                '--disable-scripts ' .
+                '--disable-doc ' .
+                '--with-libiconv ' .
+                '--prefix='
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec("make install DESTDIR={$destdir}");
+    }
+}

src/SPC/builder/linux/library/zlib.php

@@ -0,0 +1,46 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+use SPC\exception\RuntimeException;
+
+class zlib extends LinuxLibraryBase
+{
+    public const NAME = 'zlib';
+
+    /**
+     * @throws RuntimeException
+     */
+    public function build()
+    {
+        [,,$destdir] = SEPARATED_PATH;
+
+        shell()->cd($this->source_dir)
+            ->exec(
+                "{$this->builder->configure_env} ./configure " .
+                '--static ' .
+                '--prefix='
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec("make install DESTDIR={$destdir}");
+    }
+}

src/SPC/builder/linux/library/zstd.php

@@ -0,0 +1,45 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+use SPC\exception\RuntimeException;
+
+class zstd extends LinuxLibraryBase
+{
+    public const NAME = 'zstd';
+
+    /**
+     * @throws RuntimeException
+     */
+    public function build()
+    {
+        shell()->cd($this->source_dir)
+            ->exec("make {$this->builder->configure_env} PREFIX='" . BUILD_ROOT_PATH . "' clean")
+            ->exec(
+                "make -j{$this->builder->concurrency} " .
+                "{$this->builder->configure_env} " .
+                "PREFIX='" . BUILD_ROOT_PATH . "' " .
+                '-C lib libzstd.a CPPFLAGS_STATLIB=-DZSTD_MULTITHREAD'
+            )
+            ->exec('cp lib/libzstd.a ' . BUILD_LIB_PATH)
+            ->exec('cp lib/zdict.h lib/zstd_errors.h lib/zstd.h ' . BUILD_INCLUDE_PATH);
+    }
+}

src/SPC/builder/macos/MacOSBuilder.php

@@ -0,0 +1,248 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos;
+
+use SPC\builder\BuilderBase;
+use SPC\builder\macos\library\MacOSLibraryBase;
+use SPC\builder\traits\UnixBuilderTrait;
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
+use SPC\util\Patcher;
+
+/**
+ * macOS 系统环境下的构建器
+ * 源于 Config，但因为感觉叫 Config 不太合适，就换成了 Builder
+ */
+class MacOSBuilder extends BuilderBase
+{
+    /** 编译的 Unix 工具集 */
+    use UnixBuilderTrait;
+
+    /** @var bool 标记是否 patch 了 phar */
+    private bool $phar_patched = false;
+
+    /**
+     * @param  null|string         $cc   C编译器名称，如果不传入则默认使用clang
+     * @param  null|string         $cxx  C++编译器名称，如果不传入则默认使用clang++
+     * @param  null|string         $arch 当前架构，如果不传入则默认使用当前系统架构
+     * @throws RuntimeException
+     * @throws WrongUsageException
+     */
+    public function __construct(?string $cc = null, ?string $cxx = null, ?string $arch = null)
+    {
+        // 如果是 Debug 模式，才使用 set -x 显示每条执行的命令
+        $this->set_x = defined('DEBUG_MODE') ? 'set -x' : 'true';
+        // 初始化一些默认参数
+        $this->cc = $cc ?? 'clang';
+        $this->cxx = $cxx ?? 'clang++';
+        $this->arch = $arch ?? php_uname('m');
+        $this->gnu_arch = arch2gnu($this->arch);
+        // 根据 CPU 线程数设置编译进程数
+        $this->concurrency = SystemUtil::getCpuCount();
+        // 设置 cflags
+        $this->arch_c_flags = SystemUtil::getArchCFlags($this->arch);
+        $this->arch_cxx_flags = SystemUtil::getArchCFlags($this->arch);
+        // 设置 cmake
+        $this->cmake_toolchain_file = SystemUtil::makeCmakeToolchainFile('Darwin', $this->arch, $this->arch_c_flags);
+        // 设置 configure 依赖的环境变量
+        $this->configure_env =
+            'PKG_CONFIG_PATH="' . BUILD_LIB_PATH . '/pkgconfig/" ' .
+            "CC='{$this->cc}' " .
+            "CXX='{$this->cxx}' " .
+            "CFLAGS='{$this->arch_c_flags} -Wimplicit-function-declaration'";
+
+        // 创立 pkg-config 和放头文件的目录
+        f_mkdir(BUILD_LIB_PATH . '/pkgconfig', recursive: true);
+        f_mkdir(BUILD_INCLUDE_PATH, recursive: true);
+    }
+
+    /**
+     * 生成库构建采用的 autoconf 参数列表
+     *
+     * @param string $name      要构建的 lib 库名，传入仅供输出日志
+     * @param array  $lib_specs 依赖的 lib 库的 autoconf 文件
+     */
+    public function makeAutoconfArgs(string $name, array $lib_specs): string
+    {
+        $ret = '';
+        foreach ($lib_specs as $libName => $arr) {
+            $lib = $this->getLib($libName);
+
+            $arr = $arr ?? [];
+
+            $disableArgs = $arr[0] ?? null;
+            $prefix = $arr[1] ?? null;
+            if ($lib instanceof MacOSLibraryBase) {
+                logger()->info("{$name} \033[32;1mwith\033[0;1m {$libName} support");
+                $ret .= $lib->makeAutoconfEnv($prefix) . ' ';
+            } else {
+                logger()->info("{$name} \033[31;1mwithout\033[0;1m {$libName} support");
+                $ret .= ($disableArgs ?? "--with-{$libName}=no") . ' ';
+            }
+        }
+        return rtrim($ret);
+    }
+
+    /**
+     * 返回 macOS 系统依赖的框架列表
+     *
+     * @param bool $asString 是否以字符串形式返回（默认为 False）
+     */
+    public function getFrameworks(bool $asString = false): array|string
+    {
+        $libs = [];
+
+        // reorder libs
+        foreach ($this->libs as $lib) {
+            foreach ($lib->getDependencies() as $dep) {
+                $libs[] = $dep;
+            }
+            $libs[] = $lib;
+        }
+
+        $frameworks = [];
+        /** @var MacOSLibraryBase $lib */
+        foreach ($libs as $lib) {
+            array_push($frameworks, ...$lib->getFrameworks());
+        }
+
+        if ($asString) {
+            return implode(' ', array_map(fn ($x) => "-framework {$x}", $frameworks));
+        }
+        return $frameworks;
+    }
+
+    /**
+     * @throws RuntimeException
+     * @throws FileSystemException
+     */
+    public function buildPHP(int $build_target = BUILD_TARGET_NONE, bool $bloat = false): void
+    {
+        $extra_libs = $this->getFrameworks(true) . ' ' . ($this->getExt('swoole') ? '-lc++ ' : '');
+        if (!$bloat) {
+            $extra_libs .= implode(' ', $this->getAllStaticLibFiles());
+        } else {
+            logger()->info('bloat linking');
+            $extra_libs .= implode(
+                ' ',
+                array_map(
+                    fn ($x) => "-Wl,-force_load,{$x}",
+                    array_filter($this->getAllStaticLibFiles())
+                )
+            );
+        }
+
+        // patch before configure
+        Patcher::patchPHPBeforeConfigure($this);
+
+        shell()->cd(SOURCE_PATH . '/php-src')->exec('./buildconf --force');
+
+        Patcher::patchPHPConfigure($this);
+
+        if ($this->getLib('libxml2') || $this->getExt('iconv')) {
+            $extra_libs .= ' -liconv';
+        }
+
+        shell()->cd(SOURCE_PATH . '/php-src')
+            ->exec(
+                './configure ' .
+                '--prefix= ' .
+                '--with-valgrind=no ' .     // 不检测内存泄漏
+                '--enable-shared=no ' .
+                '--enable-static=yes ' .
+                "--host={$this->gnu_arch}-apple-darwin " .
+                "CFLAGS='{$this->arch_c_flags} -Werror=unknown-warning-option' " .
+                '--disable-all ' .
+                '--disable-cgi ' .
+                '--disable-phpdbg ' .
+                '--enable-cli ' .
+                '--enable-fpm ' .
+                '--enable-micro ' .
+                ($this->zts ? '--enable-zts' : '') . ' ' .
+                $this->makeExtensionArgs() . ' ' .
+                $this->configure_env
+            );
+
+        $this->cleanMake();
+
+        if (($build_target & BUILD_TARGET_CLI) === BUILD_TARGET_CLI) {
+            logger()->info('building cli');
+            $this->buildCli($extra_libs);
+        }
+        if (($build_target & BUILD_TARGET_FPM) === BUILD_TARGET_FPM) {
+            logger()->info('building fpm');
+            $this->buildFpm($extra_libs);
+        }
+        if (($build_target & BUILD_TARGET_MICRO) === BUILD_TARGET_MICRO) {
+            logger()->info('building micro');
+            $this->buildMicro($extra_libs);
+        }
+
+        if (php_uname('m') === $this->arch) {
+            $this->sanityCheck($build_target);
+        }
+
+        if ($this->phar_patched) {
+            f_passthru('cd ' . SOURCE_PATH . '/php-src && patch -p1 -R < sapi/micro/patches/phar.patch');
+        }
+    }
+
+    /**
+     * 构建 cli
+     *
+     * @throws RuntimeException
+     * @throws FileSystemException
+     */
+    public function buildCli(string $extra_libs): void
+    {
+        shell()->cd(SOURCE_PATH . '/php-src')
+            ->exec("make -j{$this->concurrency} EXTRA_CFLAGS=\"-g -Os -fno-ident\" EXTRA_LIBS=\"{$extra_libs} -lresolv\" cli")
+            ->exec('dsymutil -f sapi/cli/php')
+            ->exec('strip sapi/cli/php');
+        $this->deployBinary(BUILD_TARGET_CLI);
+    }
+
+    /**
+     * 构建 phpmicro
+     *
+     * @throws FileSystemException|RuntimeException
+     */
+    public function buildMicro(string $extra_libs): void
+    {
+        if ($this->getPHPVersionID() < 80000) {
+            throw new RuntimeException('phpmicro only support PHP >= 8.0!');
+        }
+        if ($this->getExt('phar')) {
+            $this->phar_patched = true;
+            try {
+                // TODO: 未来改进一下 patch，让除了这种 patch 类型的文件以外可以恢复原文件
+                shell()->cd(SOURCE_PATH . '/php-src')->exec('patch -p1 < sapi/micro/patches/phar.patch');
+            } catch (RuntimeException $e) {
+                logger()->error('failed to patch phat due to patch exit with code ' . $e->getCode());
+                $this->phar_patched = false;
+            }
+        }
+
+        shell()->cd(SOURCE_PATH . '/php-src')
+            ->exec("make -j{$this->concurrency} EXTRA_CFLAGS=\"-g -Os -fno-ident\" EXTRA_LIBS=\"{$extra_libs} -lresolv\" STRIP=\"dsymutil -f \" micro");
+        $this->deployBinary(BUILD_TARGET_MICRO);
+    }
+
+    /**
+     * 构建 fpm
+     *
+     * @throws RuntimeException
+     * @throws FileSystemException
+     */
+    public function buildFpm(string $extra_libs): void
+    {
+        shell()->cd(SOURCE_PATH . '/php-src')
+            ->exec("make -j{$this->concurrency} EXTRA_CFLAGS=\"-g -Os -fno-ident\" EXTRA_LIBS=\"{$extra_libs} -lresolv\" fpm")
+            ->exec('dsymutil -f sapi/fpm/php-fpm')
+            ->exec('strip sapi/fpm/php-fpm');
+        $this->deployBinary(BUILD_TARGET_FPM);
+    }
+}

src/SPC/builder/macos/SystemUtil.php

@@ -0,0 +1,45 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos;
+
+use SPC\builder\traits\UnixSystemUtilTrait;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
+
+class SystemUtil
+{
+    /** macOS 兼容 unix 的系统工具 */
+    use UnixSystemUtilTrait;
+
+    /**
+     * 获取系统 CPU 逻辑内核数
+     *
+     * @throws RuntimeException
+     */
+    public static function getCpuCount(): int
+    {
+        [$ret, $output] = shell()->execWithResult('sysctl -n hw.ncpu');
+        if ($ret !== 0) {
+            throw new RuntimeException('Failed to get cpu count');
+        }
+
+        return (int) $output[0];
+    }
+
+    /**
+     * 获取不同架构对应的 cflags 参数
+     *
+     * @param  string              $arch 架构名称
+     * @throws WrongUsageException
+     */
+    public static function getArchCFlags(string $arch): string
+    {
+        return match ($arch) {
+            'x86_64' => '--target=x86_64-apple-darwin',
+            'arm64','aarch64' => '--target=arm64-apple-darwin',
+            default => throw new WrongUsageException('unsupported arch: ' . $arch),
+        };
+    }
+}

src/SPC/builder/macos/library/MacOSLibraryBase.php

@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos\library;
+
+use SPC\builder\BuilderBase;
+use SPC\builder\LibraryBase;
+use SPC\builder\macos\MacOSBuilder;
+use SPC\builder\traits\UnixLibraryTrait;
+use SPC\store\Config;
+
+abstract class MacOSLibraryBase extends LibraryBase
+{
+    use UnixLibraryTrait;
+
+    protected array $headers;
+
+    public function __construct(protected MacOSBuilder $builder)
+    {
+        parent::__construct();
+    }
+
+    public function getBuilder(): BuilderBase
+    {
+        return $this->builder;
+    }
+
+    /**
+     * 获取当前 lib 库依赖的 macOS framework
+     */
+    public function getFrameworks(): array
+    {
+        return Config::getLib(static::NAME, 'frameworks', []);
+    }
+}

src/SPC/builder/macos/library/brotli.php

@@ -0,0 +1,47 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos\library;
+
+class brotli extends MacOSLibraryBase
+{
+    public const NAME = 'brotli';
+
+    protected function build()
+    {
+        [$lib, $include, $destdir] = SEPARATED_PATH;
+        shell()->cd($this->source_dir)
+            ->exec('rm -rf build')
+            ->exec('mkdir -p build')
+            ->cd($this->source_dir . '/build')
+            ->exec(
+                "{$this->builder->configure_env} cmake " .
+                '-DCMAKE_BUILD_TYPE=Release ' .
+                '-DBUILD_SHARED_LIBS=OFF ' .
+                '-DCMAKE_INSTALL_PREFIX=/ ' .
+                "-DCMAKE_INSTALL_LIBDIR={$lib} " .
+                "-DCMAKE_INSTALL_INCLUDEDIR={$include} " .
+                "-DCMAKE_TOOLCHAIN_FILE={$this->builder->cmake_toolchain_file} " .
+                '..'
+            )
+            ->exec("cmake --build . -j {$this->builder->concurrency}")
+            ->exec("make install DESTDIR={$destdir}");
+    }
+}

src/SPC/builder/macos/library/bzip2.php

@@ -0,0 +1,35 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos\library;
+
+class bzip2 extends MacOSLibraryBase
+{
+    public const NAME = 'bzip2';
+
+    protected function build()
+    {
+        shell()->cd($this->source_dir)
+            ->exec("make {$this->builder->configure_env} PREFIX='" . BUILD_ROOT_PATH . "' clean")
+            ->exec("make -j{$this->builder->concurrency} {$this->builder->configure_env} PREFIX='" . BUILD_ROOT_PATH . "' libbz2.a")
+            ->exec('cp libbz2.a ' . BUILD_LIB_PATH)
+            ->exec('cp bzlib.h ' . BUILD_INCLUDE_PATH);
+    }
+}

src/SPC/builder/macos/library/curl.php

@@ -0,0 +1,116 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos\library;
+
+use SPC\exception\RuntimeException;
+
+class curl extends MacOSLibraryBase
+{
+    public const NAME = 'curl';
+
+    protected function build()
+    {
+        $extra = '';
+        // lib:openssl
+        $openssl = $this->getBuilder()->getLib('openssl');
+        if ($openssl instanceof MacOSLibraryBase) {
+            $extra .= '-DCURL_USE_OPENSSL=ON ';
+        } else {
+            $extra .= '-DCURL_USE_OPENSSL=OFF -DCURL_ENABLE_SSL=OFF ';
+        }
+        // lib:zlib
+        $zlib = $this->getBuilder()->getLib('zlib');
+        if ($zlib instanceof MacOSLibraryBase) {
+            $extra .= '-DZLIB_LIBRARY="' . $zlib->getStaticLibFiles(style: 'cmake') . '" ' .
+                '-DZLIB_INCLUDE_DIR=' . BUILD_INCLUDE_PATH . ' ';
+        }
+        // lib:libssh2
+        $libssh2 = $this->builder->getLib('libssh2');
+        if ($libssh2 instanceof MacOSLibraryBase) {
+            $extra .= '-DLIBSSH2_LIBRARY="' . $libssh2->getStaticLibFiles(style: 'cmake') . '" ' .
+                '-DLIBSSH2_INCLUDE_DIR="' . BUILD_INCLUDE_PATH . '" ';
+        } else {
+            $extra .= '-DCURL_USE_LIBSSH2=OFF ';
+        }
+        // lib:brotli
+        $brotli = $this->builder->getLib('brotli');
+        if ($brotli) {
+            $extra .= '-DCURL_BROTLI=ON ' .
+                '-DBROTLIDEC_LIBRARY="' . realpath(BUILD_LIB_PATH . '/libbrotlidec-static.a') . ';' . realpath(BUILD_LIB_PATH . '/libbrotlicommon-static.a') . '" ' .
+                '-DBROTLICOMMON_LIBRARY="' . realpath(BUILD_LIB_PATH . '/libbrotlicommon-static.a') . '" ' .
+                '-DBROTLI_INCLUDE_DIR="' . BUILD_INCLUDE_PATH . '" ';
+        } else {
+            $extra .= '-DCURL_BROTLI=OFF ';
+        }
+        // lib:nghttp2
+        $nghttp2 = $this->builder->getLib('nghttp2');
+        if ($nghttp2 instanceof MacOSLibraryBase) {
+            $extra .= '-DUSE_NGHTTP2=ON ' .
+                '-DNGHTTP2_LIBRARY="' . $nghttp2->getStaticLibFiles(style: 'cmake') . '" ' .
+                '-DNGHTTP2_INCLUDE_DIR="' . BUILD_INCLUDE_PATH . '" ';
+        } else {
+            $extra .= '-DUSE_NGHTTP2=OFF ';
+        }
+        // lib:ldap
+        $ldap = $this->builder->getLib('ldap');
+        if ($ldap instanceof MacOSLibraryBase) {
+            // $extra .= '-DCURL_DISABLE_LDAP=OFF ';
+            // TODO: LDAP support
+            throw new RuntimeException('LDAP support is not implemented yet');
+        }
+        $extra .= '-DCURL_DISABLE_LDAP=ON ';
+        // lib:zstd
+        $zstd = $this->builder->getLib('zstd');
+        if ($zstd instanceof MacOSLibraryBase) {
+            $extra .= '-DCURL_ZSTD=ON ' .
+                '-DZstd_LIBRARY="' . $zstd->getStaticLibFiles(style: 'cmake') . '" ' .
+                '-DZstd_INCLUDE_DIR="' . BUILD_INCLUDE_PATH . '" ';
+        } else {
+            $extra .= '-DCURL_ZSTD=OFF ';
+        }
+        // lib:idn2
+        $idn2 = $this->builder->getLib('idn2');
+        $extra .= $idn2 instanceof MacOSLibraryBase ? '-DUSE_LIBIDN2=ON ' : '-DUSE_LIBIDN2=OFF ';
+        // lib:psl
+        $libpsl = $this->builder->getLib('psl');
+        $extra .= $libpsl instanceof MacOSLibraryBase ? '-DCURL_USE_LIBPSL=ON ' : '-DCURL_USE_LIBPSL=OFF ';
+
+        [$lib, $include, $destdir] = SEPARATED_PATH;
+        // compile！
+        shell()->cd($this->source_dir)
+            ->exec('rm -rf build')
+            ->exec('mkdir -p build')
+            ->cd($this->source_dir . '/build')
+            ->exec(
+                "{$this->builder->configure_env} cmake " .
+                '-DCMAKE_BUILD_TYPE=Release ' .
+                '-DBUILD_SHARED_LIBS=OFF ' .
+                $extra .
+                '-DCMAKE_INSTALL_PREFIX= ' .
+                "-DCMAKE_INSTALL_LIBDIR={$lib} " .
+                "-DCMAKE_INSTALL_INCLUDEDIR={$include} " .
+                "-DCMAKE_TOOLCHAIN_FILE={$this->builder->cmake_toolchain_file} " .
+                '..'
+            )
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec("make install DESTDIR={$destdir}");
+    }
+}

src/SPC/builder/macos/library/freetype.php

@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos\library;
+
+/**
+ * is a template library class for unix
+ */
+class freetype extends MacOSLibraryBase
+{
+    public const NAME = 'freetype';
+
+    protected function build()
+    {
+        [,,$destdir] = SEPARATED_PATH;
+
+        $suggested = '';
+        $suggested .= ($this->builder->getLib('libpng') instanceof MacOSLibraryBase) ? ('--with-png=' . BUILD_ROOT_PATH) : '--without-png';
+        $suggested .= ' ';
+        $suggested .= ($this->builder->getLib('bzip2') instanceof MacOSLibraryBase) ? ('--with-bzip2=' . BUILD_ROOT_PATH) : '--without-bzip2';
+        $suggested .= ' ';
+        $suggested .= ($this->builder->getLib('brotli') instanceof MacOSLibraryBase) ? ('--with-brotli=' . BUILD_ROOT_PATH) : '--without-brotli';
+        $suggested .= ' ';
+
+        shell()->cd($this->source_dir)
+            ->exec(
+                "{$this->builder->configure_env} ./configure " .
+                '--enable-static --disable-shared --without-harfbuzz --prefix= ' .
+                $suggested
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec("make install DESTDIR={$destdir}");
+    }
+}

src/SPC/builder/macos/library/gmp.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos\library;
+
+/**
+ * gmp is a template library class for unix
+ */
+class gmp extends MacOSLibraryBase
+{
+    public const NAME = 'gmp';
+
+    protected function build()
+    {
+        [,,$destdir] = SEPARATED_PATH;
+
+        shell()->cd($this->source_dir)
+            ->exec(
+                "{$this->builder->configure_env} ./configure " .
+                '--enable-static --disable-shared ' .
+                '--prefix='
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec("make install DESTDIR={$destdir}");
+    }
+}

src/SPC/builder/macos/library/libffi.php

@@ -0,0 +1,44 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos\library;
+
+class libffi extends MacOSLibraryBase
+{
+    public const NAME = 'libffi';
+
+    protected function build()
+    {
+        [$lib, , $destdir] = SEPARATED_PATH;
+        shell()->cd($this->source_dir)
+            ->exec(
+                "{$this->builder->configure_env} ./configure " .
+                '--enable-static ' .
+                '--disable-shared ' .
+                "--host={$this->builder->arch}-apple-darwin " .
+                "--target={$this->builder->arch}-apple-darwin " .
+                '--prefix= ' . // use prefix=/
+                "--libdir={$lib}"
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec("make install DESTDIR={$destdir}");
+    }
+}

src/SPC/builder/macos/library/libiconv.php

@@ -0,0 +1,47 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos\library;
+
+use SPC\exception\RuntimeException;
+
+class libiconv extends MacOSLibraryBase
+{
+    public const NAME = 'libiconv';
+
+    /**
+     * @throws RuntimeException
+     */
+    public function build()
+    {
+        [,,$destdir] = SEPARATED_PATH;
+
+        shell()->cd($this->source_dir)
+            ->exec(
+                "{$this->builder->configure_env} ./configure " .
+                '--enable-static ' .
+                '--disable-shared ' .
+                '--prefix='
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec('make install DESTDIR=' . $destdir);
+    }
+}

src/SPC/builder/macos/library/libpng.php

@@ -0,0 +1,63 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos\library;
+
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\util\Patcher;
+
+class libpng extends MacOSLibraryBase
+{
+    public const NAME = 'libpng';
+
+    /**
+     * @throws FileSystemException
+     * @throws RuntimeException
+     */
+    protected function build()
+    {
+        // 不同架构的专属优化
+        $optimizations = match ($this->builder->arch) {
+            'x86_64' => '--enable-intel-sse ',
+            'arm64' => '--enable-arm-neon ',
+            default => '',
+        };
+
+        // patch configure
+        Patcher::patchUnixLibpng();
+        shell()->cd($this->source_dir)
+            ->exec('chmod +x ./configure')
+            ->exec(
+                "{$this->builder->configure_env} ./configure " .
+                "--host={$this->builder->gnu_arch}-apple-darwin " .
+                '--disable-shared ' .
+                '--enable-static ' .
+                '--enable-hardware-optimizations ' .
+                $optimizations .
+                '--prefix='
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency} DEFAULT_INCLUDES='-I. -I" . BUILD_INCLUDE_PATH . "' LIBS= libpng16.la")
+            ->exec('make install-libLTLIBRARIES install-data-am DESTDIR=' . BUILD_ROOT_PATH)
+            ->cd(BUILD_LIB_PATH)
+            ->exec('ln -sf libpng16.a libpng.a');
+    }
+}

src/SPC/builder/macos/library/libssh2.php

@@ -0,0 +1,54 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos\library;
+
+class libssh2 extends MacOSLibraryBase
+{
+    public const NAME = 'libssh2';
+
+    protected function build()
+    {
+        // lib:zlib
+        $enable_zlib = $this->builder->getLib('zlib') !== null ? 'ON' : 'OFF';
+
+        [$lib, $include, $destdir] = SEPARATED_PATH;
+
+        shell()->cd($this->source_dir)
+            ->exec('rm -rf build')
+            ->exec('mkdir -p build')
+            ->cd($this->source_dir . '/build')
+            ->exec(
+                "{$this->builder->configure_env} " . ' cmake ' .
+                '-DCMAKE_BUILD_TYPE=Release ' .
+                '-DBUILD_SHARED_LIBS=OFF ' .
+                '-DBUILD_EXAMPLES=OFF ' .
+                '-DBUILD_TESTING=OFF ' .
+                "-DENABLE_ZLIB_COMPRESSION={$enable_zlib} " .
+                '-DCMAKE_INSTALL_PREFIX=/ ' .
+                "-DCMAKE_INSTALL_LIBDIR={$lib} " .
+                "-DCMAKE_INSTALL_INCLUDEDIR={$include} " .
+                "-DCMAKE_TOOLCHAIN_FILE={$this->builder->cmake_toolchain_file} " .
+                '..'
+            )
+            ->exec("cmake --build . -j {$this->builder->concurrency} --target libssh2")
+            ->exec("make install DESTDIR={$destdir}");
+    }
+}

src/SPC/builder/macos/library/libxml2.php

@@ -0,0 +1,65 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos\library;
+
+use SPC\exception\RuntimeException;
+
+class libxml2 extends MacOSLibraryBase
+{
+    public const NAME = 'libxml2';
+
+    /**
+     * @throws RuntimeException
+     */
+    protected function build()
+    {
+        $enable_zlib = $this->builder->getLib('zlib') ? 'ON' : 'OFF';
+        $enable_icu = $this->builder->getLib('icu') ? 'ON' : 'OFF';
+        $enable_xz = $this->builder->getLib('xz') ? 'ON' : 'OFF';
+
+        [$lib, $include, $destdir] = SEPARATED_PATH;
+
+        shell()->cd($this->source_dir)
+            ->exec('rm -rf build')
+            ->exec('mkdir -p build')
+            ->cd($this->source_dir . '/build')
+            ->exec(
+                "{$this->builder->configure_env} " . ' cmake ' .
+                // '--debug-find ' .
+                '-DCMAKE_BUILD_TYPE=Release ' .
+                '-DBUILD_SHARED_LIBS=OFF ' .
+                '-DLIBXML2_WITH_ICONV=ON ' .
+                "-DLIBXML2_WITH_ZLIB={$enable_zlib} " .
+                "-DLIBXML2_WITH_ICU={$enable_icu} " .
+                "-DLIBXML2_WITH_LZMA={$enable_xz} " .
+                '-DLIBXML2_WITH_PYTHON=OFF ' .
+                '-DLIBXML2_WITH_PROGRAMS=OFF ' .
+                '-DLIBXML2_WITH_TESTS=OFF ' .
+                '-DCMAKE_INSTALL_PREFIX=/ ' .
+                "-DCMAKE_INSTALL_LIBDIR={$lib} " .
+                "-DCMAKE_INSTALL_INCLUDEDIR={$include} " .
+                "-DCMAKE_TOOLCHAIN_FILE={$this->builder->cmake_toolchain_file} " .
+                '..'
+            )
+            ->exec("cmake --build . -j {$this->builder->concurrency}")
+            ->exec("make install DESTDIR={$destdir}");
+    }
+}

src/SPC/builder/macos/library/libyaml.php

@@ -0,0 +1,94 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos\library;
+
+use SPC\exception\RuntimeException;
+
+class libyaml extends MacOSLibraryBase
+{
+    public const NAME = 'libyaml';
+
+    /**
+     * @throws RuntimeException
+     */
+    public function build()
+    {
+        // prepare cmake/config.h.in
+        if (!is_file(SOURCE_PATH . '/libyaml/cmake/config.h.in')) {
+            f_mkdir(SOURCE_PATH . '/libyaml/cmake');
+            file_put_contents(
+                SOURCE_PATH . '/libyaml/cmake/config.h.in',
+                <<<'EOF'
+#define YAML_VERSION_MAJOR @YAML_VERSION_MAJOR@
+#define YAML_VERSION_MINOR @YAML_VERSION_MINOR@
+#define YAML_VERSION_PATCH @YAML_VERSION_PATCH@
+#define YAML_VERSION_STRING "@YAML_VERSION_STRING@"
+EOF
+            );
+        }
+
+        // prepare yamlConfig.cmake.in
+        if (!is_file(SOURCE_PATH . '/libyaml/yamlConfig.cmake.in')) {
+            file_put_contents(
+                SOURCE_PATH . '/libyaml/yamlConfig.cmake.in',
+                <<<'EOF'
+# Config file for the yaml library.
+#
+# It defines the following variables:
+#   yaml_LIBRARIES    - libraries to link against
+
+@PACKAGE_INIT@
+
+set_and_check(yaml_TARGETS "@PACKAGE_CONFIG_DIR_CONFIG@/yamlTargets.cmake")
+
+if(NOT yaml_TARGETS_IMPORTED)
+  set(yaml_TARGETS_IMPORTED 1)
+  include(${yaml_TARGETS})
+endif()
+
+set(yaml_LIBRARIES yaml)
+
+EOF
+            );
+        }
+
+        [$lib, $include, $destdir] = SEPARATED_PATH;
+
+        shell()->cd($this->source_dir)
+            ->exec('rm -rf build')
+            ->exec('mkdir -p build')
+            ->cd($this->source_dir . '/build')
+            ->exec(
+                "{$this->builder->configure_env} " . ' cmake ' .
+                // '--debug-find ' .
+                '-DCMAKE_BUILD_TYPE=Release ' .
+                '-DBUILD_TESTING=OFF ' .
+                '-DBUILD_SHARED_LIBS=OFF ' .
+                '-DCMAKE_INSTALL_PREFIX=/ ' .
+                "-DCMAKE_INSTALL_LIBDIR={$lib} " .
+                "-DCMAKE_INSTALL_INCLUDEDIR={$include} " .
+                "-DCMAKE_TOOLCHAIN_FILE={$this->builder->cmake_toolchain_file} " .
+                '..'
+            )
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec("make install DESTDIR={$destdir}");
+    }
+}

src/SPC/builder/macos/library/libzip.php

@@ -0,0 +1,100 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos\library;
+
+class libzip extends MacOSLibraryBase
+{
+    public const NAME = 'libzip';
+
+    protected function build()
+    {
+        $extra = '';
+        // lib:zlib
+        $zlib = $this->builder->getLib('zlib');
+        if ($zlib instanceof MacOSLibraryBase) {
+            $extra .= '-DZLIB_LIBRARY="' . $zlib->getStaticLibFiles(style: 'cmake') . '" ' .
+                '-DZLIB_INCLUDE_DIR=' . BUILD_INCLUDE_PATH . ' ';
+        }
+        // lib:bzip2
+        $libbzip2 = $this->builder->getLib('bzip2');
+        if ($libbzip2 instanceof MacOSLibraryBase) {
+            $extra .= '-DENABLE_BZIP2=ON ' .
+                '-DBZIP2_LIBRARIES="' . $libbzip2->getStaticLibFiles(style: 'cmake') . '" ' .
+                '-DBZIP2_INCLUDE_DIR=' . BUILD_INCLUDE_PATH . ' ';
+        } else {
+            $extra .= '-DENABLE_BZIP2=OFF ';
+        }
+        // lib:xz
+        $xz = $this->builder->getLib('xz');
+        if ($xz instanceof MacOSLibraryBase) {
+            $extra .= '-DENABLE_LZMA=ON ' .
+                '-DLIBLZMA_LIBRARY="' . $xz->getStaticLibFiles(style: 'cmake') . '" ' .
+                '-DLIBLZMA_INCLUDE_DIR=' . BUILD_INCLUDE_PATH . ' ';
+        } else {
+            $extra .= '-DENABLE_LZMA=OFF ';
+        }
+        // lib:zstd
+        $libzstd = $this->builder->getLib('zstd');
+        if ($libzstd instanceof MacOSLibraryBase) {
+            $extra .= '-DENABLE_ZSTD=ON ' .
+                '-DZstd_LIBRARY="' . $libzstd->getStaticLibFiles(style: 'cmake') . '" ' .
+                '-DZstd_INCLUDE_DIR="' . BUILD_INCLUDE_PATH . '" ';
+        } else {
+            $extra .= '-DENABLE_ZSTD=OFF ';
+        }
+        // lib:openssl
+        $libopenssl = $this->builder->getLib('openssl');
+        if ($libopenssl instanceof MacOSLibraryBase) {
+            $extra .= '-DENABLE_OPENSSL=ON ' .
+                '-DOpenSSL_LIBRARY="' . $libopenssl->getStaticLibFiles(style: 'cmake') . '" ' .
+                '-DOpenSSL_INCLUDE_DIR="' . BUILD_INCLUDE_PATH . '" ';
+        } else {
+            $extra .= '-DENABLE_OPENSSL=OFF ';
+        }
+
+        [$lib, $include, $destdir] = SEPARATED_PATH;
+
+        shell()->cd($this->source_dir)
+            ->exec('rm -rf build')
+            ->exec('mkdir -p build')
+            ->cd($this->source_dir . '/build')
+            ->exec(
+                "{$this->builder->configure_env} " . ' cmake ' .
+                // '--debug-find ' .
+                '-DCMAKE_BUILD_TYPE=Release ' .
+                '-DENABLE_GNUTLS=OFF ' .
+                '-DENABLE_MBEDTLS=OFF ' .
+                '-DBUILD_SHARED_LIBS=OFF ' .
+                '-DBUILD_DOC=OFF ' .
+                '-DBUILD_EXAMPLES=OFF ' .
+                '-DBUILD_REGRESS=OFF ' .
+                '-DBUILD_TOOLS=OFF ' .
+                $extra .
+                '-DCMAKE_INSTALL_PREFIX=/ ' .
+                "-DCMAKE_INSTALL_LIBDIR={$lib} " .
+                "-DCMAKE_INSTALL_INCLUDEDIR={$include} " .
+                "-DCMAKE_TOOLCHAIN_FILE={$this->builder->cmake_toolchain_file} " .
+                '..'
+            )
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec("make install DESTDIR={$destdir}");
+    }
+}

src/SPC/builder/macos/library/nghttp2.php

@@ -0,0 +1,62 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos\library;
+
+class nghttp2 extends MacOSLibraryBase
+{
+    public const NAME = 'nghttp2';
+
+    protected function build()
+    {
+        $args = $this->builder->makeAutoconfArgs(static::NAME, [
+            'zlib' => null,
+            'openssl' => null,
+            'libxml2' => null,
+            'libev' => null,
+            'libcares' => null,
+            'libngtcp2' => null,
+            'libnghttp3' => null,
+            'libbpf' => null,
+            'libevent-openssl' => null,
+            'jansson' => null,
+            'jemalloc' => null,
+            'systemd' => null,
+            'cunit' => null,
+        ]);
+
+        [,,$destdir] = SEPARATED_PATH;
+
+        shell()->cd($this->source_dir)
+            ->exec(
+                "{$this->builder->configure_env} " . ' ./configure ' .
+                '--enable-static ' .
+                '--disable-shared ' .
+                "--host={$this->builder->gnu_arch}-apple-darwin " .
+                '--enable-lib-only ' .
+                '--with-boost=no ' .
+                $args . ' ' .
+                '--prefix='
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec("make install DESTDIR={$destdir}");
+    }
+}

src/SPC/builder/macos/library/onig.php

@@ -0,0 +1,43 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos\library;
+
+class onig extends MacOSLibraryBase
+{
+    public const NAME = 'onig';
+
+    protected function build()
+    {
+        [,,$destdir] = SEPARATED_PATH;
+
+        shell()->cd($this->source_dir)
+            ->exec(
+                "{$this->builder->configure_env} " . ' ./configure ' .
+                '--enable-static ' .
+                '--disable-shared ' .
+                "--host={$this->builder->arch}-apple-darwin " .
+                '--prefix='
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec("make install DESTDIR={$destdir}");
+    }
+}

src/SPC/builder/macos/library/openssl.php

@@ -0,0 +1,51 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos\library;
+
+class openssl extends MacOSLibraryBase
+{
+    public const NAME = 'openssl';
+
+    protected function build()
+    {
+        [$lib,,$destdir] = SEPARATED_PATH;
+
+        // lib:zlib
+        $extra = '';
+        $ex_lib = '';
+        $zlib = $this->builder->getLib('zlib');
+        if ($zlib instanceof MacOSLibraryBase) {
+            $extra = 'zlib';
+            $ex_lib = trim($zlib->getStaticLibFiles() . ' ' . $ex_lib);
+        }
+
+        shell()->cd($this->source_dir)
+            ->exec(
+                "{$this->builder->configure_env} ./Configure no-shared {$extra} " .
+                '--prefix=/ ' . // use prefix=/
+                "--libdir={$lib} " .
+                " darwin64-{$this->builder->arch}-cc"
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency} CNF_EX_LIBS=\"{$ex_lib}\"")
+            ->exec("make install_sw DESTDIR={$destdir}");
+    }
+}

src/SPC/builder/macos/library/sqlite.php

@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos\library;
+
+class sqlite extends MacOSLibraryBase
+{
+    public const NAME = 'sqlite';
+
+    protected function build()
+    {
+        [,,$destdir] = SEPARATED_PATH;
+        shell()->cd($this->source_dir)
+            ->exec("{$this->builder->configure_env} ./configure --enable-static --disable-shared --prefix=")
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec("make install DESTDIR={$destdir}");
+    }
+}

src/SPC/builder/macos/library/xz.php

@@ -0,0 +1,51 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos\library;
+
+class xz extends MacOSLibraryBase
+{
+    public const NAME = 'xz';
+
+    protected function build()
+    {
+        [,,$destdir] = SEPARATED_PATH;
+
+        shell()->cd($this->source_dir)
+            ->exec('autoreconf -i --force')
+            ->exec(
+                "{$this->builder->configure_env} ./configure " .
+                '--enable-static ' .
+                '--disable-shared ' .
+                "--host={$this->builder->gnu_arch}-apple-darwin " .
+                '--disable-xz ' .
+                '--disable-xzdec ' .
+                '--disable-lzmadec ' .
+                '--disable-lzmainfo ' .
+                '--disable-scripts ' .
+                '--disable-doc ' .
+                '--with-libiconv ' .
+                '--prefix='
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec("make install DESTDIR={$destdir}");
+    }
+}

src/SPC/builder/macos/library/zlib.php

@@ -0,0 +1,37 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos\library;
+
+class zlib extends MacOSLibraryBase
+{
+    public const NAME = 'zlib';
+
+    protected function build()
+    {
+        [,,$destdir] = SEPARATED_PATH;
+
+        shell()->cd($this->source_dir)
+            ->exec("{$this->builder->configure_env} ./configure --static --prefix=")
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec("make install DESTDIR={$destdir}");
+    }
+}

src/SPC/builder/macos/library/zstd.php

@@ -0,0 +1,40 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos\library;
+
+class zstd extends MacOSLibraryBase
+{
+    public const NAME = 'zstd';
+
+    protected function build()
+    {
+        shell()->cd($this->source_dir)
+            ->exec("make {$this->builder->configure_env} PREFIX='" . BUILD_ROOT_PATH . "' clean")
+            ->exec(
+                "make -j{$this->builder->concurrency} " .
+                "{$this->builder->configure_env} " .
+                "PREFIX='" . BUILD_ROOT_PATH . "' " .
+                '-C lib libzstd.a CPPFLAGS_STATLIB=-DZSTD_MULTITHREAD'
+            )
+            ->exec('cp lib/libzstd.a ' . BUILD_LIB_PATH)
+            ->exec('cp lib/zdict.h  lib/zstd_errors.h  lib/zstd.h ' . BUILD_INCLUDE_PATH);
+    }
+}

src/SPC/builder/traits/LibraryTrait.php

@@ -0,0 +1,9 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\traits;
+
+trait LibraryTrait
+{
+}

src/SPC/builder/traits/UnixBuilderTrait.php

@@ -0,0 +1,136 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\traits;
+
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\store\FileSystem;
+
+trait UnixBuilderTrait
+{
+    /** @var string 设置的命令前缀，设置为 set -x 可以在终端打印命令 */
+    public string $set_x = 'set -x';
+
+    /** @var string C 编译器命令 */
+    public string $cc;
+
+    /** @var string C++ 编译器命令 */
+    public string $cxx;
+
+    /** @var string cflags 参数 */
+    public string $arch_c_flags;
+
+    /** @var string C++ flags 参数 */
+    public string $arch_cxx_flags;
+
+    /** @var string cmake toolchain file */
+    public string $cmake_toolchain_file;
+
+    /** @var string configure 环境依赖的变量 */
+    public string $configure_env;
+
+    public function getAllStaticLibFiles(): array
+    {
+        $libs = [];
+
+        // reorder libs
+        foreach ($this->libs as $lib) {
+            foreach ($lib->getDependencies() as $dep) {
+                $libs[] = $dep;
+            }
+            $libs[] = $lib;
+        }
+
+        $libFiles = [];
+        $libNames = [];
+        // merge libs
+        foreach ($libs as $lib) {
+            if (!in_array($lib::NAME, $libNames, true)) {
+                $libNames[] = $lib::NAME;
+                array_unshift($libFiles, ...$lib->getStaticLibs());
+            }
+        }
+        return array_map(fn ($x) => realpath(BUILD_LIB_PATH . "/{$x}"), $libFiles);
+    }
+
+    /**
+     * Sanity check after build complete
+     *
+     * @throws RuntimeException
+     */
+    public function sanityCheck(int $build_target): void
+    {
+        // sanity check for php-cli
+        if (($build_target & BUILD_TARGET_CLI) === BUILD_TARGET_CLI) {
+            logger()->info('running cli sanity check');
+            [$ret, $output] = shell()->execWithResult(BUILD_ROOT_PATH . '/bin/php -r "echo \"hello\";"');
+            if ($ret !== 0 || trim(implode('', $output)) !== 'hello') {
+                throw new RuntimeException('cli failed sanity check');
+            }
+            foreach ($this->exts as $ext) {
+                logger()->debug('testing ext: ' . $ext->getName());
+                [$ret] = shell()->execWithResult(BUILD_ROOT_PATH . '/bin/php --ri ' . $ext->getDistName(), false);
+                if ($ret !== 0) {
+                    throw new RuntimeException('extension ' . $ext->getName() . ' failed compile check');
+                }
+                if (file_exists(ROOT_DIR . '/src/globals/tests/' . $ext->getName() . '.php')) {
+                    [$ret] = shell()->execWithResult(BUILD_ROOT_PATH . '/bin/php ' . ROOT_DIR . '/src/globals/tests/' . $ext->getName() . '.php');
+                    if ($ret !== 0) {
+                        throw new RuntimeException('extension ' . $ext->getName() . ' failed sanity check');
+                    }
+                }
+            }
+        }
+
+        // sanity check for phpmicro
+        if (($build_target & BUILD_TARGET_MICRO) === BUILD_TARGET_MICRO) {
+            if (file_exists(SOURCE_PATH . '/hello.exe')) {
+                @unlink(SOURCE_PATH . '/hello.exe');
+            }
+            file_put_contents(
+                SOURCE_PATH . '/hello.exe',
+                file_get_contents(SOURCE_PATH . '/php-src/sapi/micro/micro.sfx') .
+                '<?php echo "hello";'
+            );
+            chmod(SOURCE_PATH . '/hello.exe', 0755);
+            [$ret, $output2] = shell()->execWithResult(SOURCE_PATH . '/hello.exe');
+            if ($ret !== 0 || trim($out = implode('', $output2)) !== 'hello') {
+                throw new RuntimeException('micro failed sanity check, ret[' . $ret . '], out[' . ($out ?? 'NULL') . ']');
+            }
+        }
+    }
+
+    /**
+     * 将编译好的二进制文件发布到 buildroot
+     *
+     * @param  int                 $type 发布类型
+     * @throws RuntimeException
+     * @throws FileSystemException
+     */
+    public function deployBinary(int $type): bool
+    {
+        $src = match ($type) {
+            BUILD_TARGET_CLI => SOURCE_PATH . '/php-src/sapi/cli/php',
+            BUILD_TARGET_MICRO => SOURCE_PATH . '/php-src/sapi/micro/micro.sfx',
+            BUILD_TARGET_FPM => SOURCE_PATH . '/php-src/sapi/fpm/php-fpm',
+            default => throw new RuntimeException('Deployment does not accept type ' . $type),
+        };
+        logger()->info('Deploying ' . $this->getBuildTypeName($type) . ' file');
+        FileSystem::createDir(BUILD_ROOT_PATH . '/bin');
+        shell()->exec('cp ' . escapeshellarg($src) . ' ' . escapeshellarg(BUILD_ROOT_PATH . '/bin/'));
+        return true;
+    }
+
+    /**
+     * 清理编译好的文件
+     *
+     * @throws RuntimeException
+     */
+    public function cleanMake(): void
+    {
+        logger()->info('cleaning up');
+        shell()->cd(SOURCE_PATH . '/php-src')->exec('make clean');
+    }
+}

src/SPC/builder/traits/UnixLibraryTrait.php

@@ -0,0 +1,54 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\traits;
+
+use SPC\builder\LibraryBase;
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\store\FileSystem;
+
+trait UnixLibraryTrait
+{
+    use LibraryTrait;
+
+    /**
+     * @throws RuntimeException
+     * @throws FileSystemException
+     */
+    public function getStaticLibFiles(string $style = 'autoconf', bool $recursive = true): string
+    {
+        $libs = [$this];
+        if ($recursive) {
+            array_unshift($libs, ...array_values($this->getDependencies(recursive: true)));
+        }
+
+        $sep = match ($style) {
+            'autoconf' => ' ',
+            'cmake' => ';',
+            default => throw new RuntimeException('style only support autoconf and cmake'),
+        };
+        $ret = [];
+        /** @var LibraryBase $lib */
+        foreach ($libs as $lib) {
+            $libFiles = [];
+            foreach ($lib->getStaticLibs() as $name) {
+                $name = str_replace(' ', '\ ', FileSystem::convertPath(BUILD_LIB_PATH . "/{$name}"));
+                $name = str_replace('"', '\"', $name);
+                $libFiles[] = $name;
+            }
+            array_unshift($ret, implode($sep, $libFiles));
+        }
+        return implode($sep, $ret);
+    }
+
+    public function makeAutoconfEnv(string $prefix = null): string
+    {
+        if ($prefix === null) {
+            $prefix = str_replace('-', '_', strtoupper(static::NAME));
+        }
+        return $prefix . '_CFLAGS="-I' . BUILD_INCLUDE_PATH . '" ' .
+            $prefix . '_LIBS="' . $this->getStaticLibFiles() . '"';
+    }
+}

src/SPC/builder/traits/UnixSystemUtilTrait.php

@@ -0,0 +1,74 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\traits;
+
+use SPC\store\FileSystem;
+
+/**
+ * Unix 系统的工具函数 Trait，适用于 Linux、macOS
+ */
+trait UnixSystemUtilTrait
+{
+    /**
+     * 生成 toolchain.cmake，用于 cmake 构建
+     *
+     * @param string      $os          操作系统代号
+     * @param string      $target_arch 目标架构
+     * @param string      $cflags      CFLAGS 参数
+     * @param null|string $cc          CC 参数（默认空）
+     * @param null|string $cxx         CXX 参数（默认空）
+     */
+    public static function makeCmakeToolchainFile(
+        string $os,
+        string $target_arch,
+        string $cflags,
+        ?string $cc = null,
+        ?string $cxx = null
+    ): string {
+        logger()->debug("making cmake tool chain file for {$os} {$target_arch} with CFLAGS='{$cflags}'");
+        $root = BUILD_ROOT_PATH;
+        $ccLine = '';
+        if ($cc) {
+            $ccLine = 'SET(CMAKE_C_COMPILER ' . self::findCommand($cc) . ')';
+        }
+        $cxxLine = '';
+        if ($cxx) {
+            $cxxLine = 'SET(CMAKE_CXX_COMPILER ' . self::findCommand($cxx) . ')';
+        }
+        $toolchain = <<<CMAKE
+SET(CMAKE_SYSTEM_NAME {$os})
+SET(CMAKE_SYSTEM_PROCESSOR {$target_arch})
+{$ccLine}
+{$cxxLine}
+SET(CMAKE_C_FLAGS "{$cflags}")
+SET(CMAKE_CXX_FLAGS "{$cflags}")
+SET(CMAKE_FIND_ROOT_PATH "{$root}")
+CMAKE;
+        // 有时候系统的 cmake 找不到 ar 命令，真奇怪
+        if (PHP_OS_FAMILY === 'Linux') {
+            $toolchain .= "\nSET(CMAKE_AR \"ar\")";
+        }
+        FileSystem::writeFile(SOURCE_PATH . '/toolchain.cmake', $toolchain);
+        return realpath(SOURCE_PATH . '/toolchain.cmake');
+    }
+
+    /**
+     * @param  string      $name  命令名称
+     * @param  array       $paths 寻找的目标路径（如果不传入，则使用环境变量 PATH）
+     * @return null|string 找到了返回命令路径，找不到返回 null
+     */
+    public static function findCommand(string $name, array $paths = []): ?string
+    {
+        if (!$paths) {
+            $paths = explode(PATH_SEPARATOR, getenv('PATH'));
+        }
+        foreach ($paths as $path) {
+            if (file_exists($path . DIRECTORY_SEPARATOR . $name)) {
+                return $path . DIRECTORY_SEPARATOR . $name;
+            }
+        }
+        return null;
+    }
+}

src/SPC/command/BaseCommand.php

@@ -0,0 +1,117 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\command;
+
+use Psr\Log\LogLevel;
+use SPC\ConsoleApplication;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Output\OutputInterface;
+use ZM\Logger\ConsoleLogger;
+
+abstract class BaseCommand extends Command
+{
+    protected bool $no_motd = false;
+
+    /**
+     * 输入
+     */
+    protected InputInterface $input;
+
+    /**
+     * 输出
+     *
+     * 一般来说同样会是 ConsoleOutputInterface
+     */
+    protected OutputInterface $output;
+
+    public function __construct(string $name = null)
+    {
+        parent::__construct($name);
+        $this->addOption('debug', null, null, 'Enable debug mode');
+        $this->addOption('no-motd', null, null, 'Disable motd');
+    }
+
+    public function initialize(InputInterface $input, OutputInterface $output)
+    {
+        if ($input->getOption('no-motd')) {
+            $this->no_motd = true;
+        }
+        // 注册全局错误处理器
+        set_error_handler(static function ($error_no, $error_msg, $error_file, $error_line) {
+            $tips = [
+                E_WARNING => ['PHP Warning: ', 'warning'],
+                E_NOTICE => ['PHP Notice: ', 'notice'],
+                E_USER_ERROR => ['PHP Error: ', 'error'],
+                E_USER_WARNING => ['PHP Warning: ', 'warning'],
+                E_USER_NOTICE => ['PHP Notice: ', 'notice'],
+                E_STRICT => ['PHP Strict: ', 'notice'],
+                E_RECOVERABLE_ERROR => ['PHP Recoverable Error: ', 'error'],
+                E_DEPRECATED => ['PHP Deprecated: ', 'notice'],
+                E_USER_DEPRECATED => ['PHP User Deprecated: ', 'notice'],
+            ];
+            $level_tip = $tips[$error_no] ?? ['PHP Unknown: ', 'error'];
+            $error = $level_tip[0] . $error_msg . ' in ' . $error_file . ' on ' . $error_line;
+            logger()->{$level_tip[1]}($error);
+            // 如果 return false 则错误会继续递交给 PHP 标准错误处理
+            return true;
+        }, E_ALL | E_STRICT);
+        if ($input->getOption('debug')) {
+            global $ob_logger;
+            $ob_logger = new ConsoleLogger(LogLevel::DEBUG);
+            define('DEBUG_MODE', true);
+        }
+        $version = ConsoleApplication::VERSION;
+        if (!$this->no_motd) {
+            echo "     _        _   _                 _           
+ ___| |_ __ _| |_(_) ___      _ __ | |__  _ __  
+/ __| __/ _` | __| |/ __|____| '_ \\| '_ \\| '_ \\ 
+\\__ \\ || (_| | |_| | (_|_____| |_) | | | | |_) |
+|___/\\__\\__,_|\\__|_|\\___|    | .__/|_| |_| .__/   v{$version}
+                             |_|         |_|    
+";
+        }
+    }
+
+    abstract public function handle(): int;
+
+    protected function execute(InputInterface $input, OutputInterface $output): int
+    {
+        $this->input = $input;
+        $this->output = $output;
+        if ($this->shouldExecute()) {
+            try {
+                return $this->handle();
+            } catch (\Throwable $e) {
+                $msg = explode("\n", $e->getMessage());
+                foreach ($msg as $v) {
+                    logger()->error($v);
+                }
+                return self::FAILURE;
+            }
+        }
+        return self::SUCCESS;
+    }
+
+    protected function getOption(string $name): mixed
+    {
+        return $this->input->getOption($name);
+    }
+
+    protected function getArgument(string $name): mixed
+    {
+        return $this->input->getArgument($name);
+    }
+
+    /**
+     * 是否应该执行
+     *
+     * @return bool 返回 true 以继续执行，返回 false 以中断执行
+     */
+    protected function shouldExecute(): bool
+    {
+        return true;
+    }
+}

src/SPC/command/BuildCliCommand.php

@@ -0,0 +1,106 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\command;
+
+use SPC\builder\BuilderProvider;
+use SPC\exception\ExceptionHandler;
+use SPC\exception\WrongUsageException;
+use SPC\util\DependencyUtil;
+use SPC\util\LicenseDumper;
+use Symfony\Component\Console\Attribute\AsCommand;
+use Symfony\Component\Console\Input\InputArgument;
+use Symfony\Component\Console\Input\InputOption;
+use ZM\Logger\ConsoleColor;
+
+#[AsCommand('build', 'build CLI binary')]
+class BuildCliCommand extends BuildCommand
+{
+    public function configure()
+    {
+        $this->addArgument('extensions', InputArgument::REQUIRED, 'The extensions will be compiled, comma separated');
+        $this->addOption('with-libs', null, InputOption::VALUE_REQUIRED, 'add additional libraries, comma separated', '');
+        $this->addOption('build-micro', null, null, 'build micro');
+        $this->addOption('build-cli', null, null, 'build cli');
+        $this->addOption('build-fpm', null, null, 'build fpm');
+        $this->addOption('build-all', null, null, 'build cli, micro, fpm');
+    }
+
+    public function handle(): int
+    {
+        // 从参数中获取要编译的 libraries，并转换为数组
+        $libraries = array_map('trim', array_filter(explode(',', $this->getOption('with-libs'))));
+        // 从参数中获取要编译的 extensions，并转换为数组
+        $extensions = array_map('trim', array_filter(explode(',', $this->getArgument('extensions'))));
+
+        define('BUILD_ALL_STATIC', true);
+
+        $rule = BUILD_TARGET_NONE;
+        $rule = $rule | ($this->getOption('build-cli') ? BUILD_TARGET_CLI : BUILD_TARGET_NONE);
+        $rule = $rule | ($this->getOption('build-micro') ? BUILD_TARGET_MICRO : BUILD_TARGET_NONE);
+        $rule = $rule | ($this->getOption('build-fpm') ? BUILD_TARGET_FPM : BUILD_TARGET_NONE);
+        $rule = $rule | ($this->getOption('build-all') ? BUILD_TARGET_ALL : BUILD_TARGET_NONE);
+        if ($rule === BUILD_TARGET_NONE) {
+            $this->output->writeln('<error>Please add at least one build target!</error>');
+            $this->output->writeln("<comment>\t--build-cli\tBuild php-cli SAPI</comment>");
+            $this->output->writeln("<comment>\t--build-micro\tBuild phpmicro SAPI</comment>");
+            $this->output->writeln("<comment>\t--build-fpm\tBuild php-fpm SAPI</comment>");
+            $this->output->writeln("<comment>\t--build-all\tBuild all SAPI: cli, micro, fpm</comment>");
+            return 1;
+        }
+        try {
+            // 构建对象
+            $builder = BuilderProvider::makeBuilderByInput($this->input);
+            // 根据提供的扩展列表获取依赖库列表并编译
+            [$extensions, $libraries, $not_included] = DependencyUtil::getExtLibsByDeps($extensions, $libraries);
+            /* @phpstan-ignore-next-line */
+            logger()->info('Build target: ' . ConsoleColor::yellow($builder->getBuildTypeName($rule)));
+            /* @phpstan-ignore-next-line */
+            logger()->info('Enabled extensions: ' . ConsoleColor::yellow(implode(', ', $extensions)));
+            /* @phpstan-ignore-next-line */
+            logger()->info('Required libraries: ' . ConsoleColor::yellow(implode(', ', $libraries)));
+            if (!empty($not_included)) {
+                logger()->warning('some extensions will be enabled due to dependencies: ' . implode(',', $not_included));
+            }
+            sleep(2);
+            // 编译和检查库是否完整
+            $builder->buildLibs($libraries);
+            // 执行扩展检测
+            $builder->proveExts($extensions);
+            // 构建
+            $builder->buildPHP($rule, $this->getOption('bloat'));
+            // 统计时间
+            $time = round(microtime(true) - START_TIME, 3);
+            logger()->info('Build complete, used ' . $time . ' s !');
+            if (($rule & BUILD_TARGET_CLI) === BUILD_TARGET_CLI) {
+                logger()->info('Static php binary path: ' . BUILD_ROOT_PATH . '/bin/php');
+            }
+            if (($rule & BUILD_TARGET_MICRO) === BUILD_TARGET_MICRO) {
+                logger()->info('phpmicro binary path: ' . BUILD_ROOT_PATH . '/bin/micro.sfx');
+            }
+            if (($rule & BUILD_TARGET_FPM) === BUILD_TARGET_FPM) {
+                logger()->info('Static php-fpm binary path: ' . BUILD_ROOT_PATH . '/bin/php-fpm');
+            }
+            // 导出相关元数据
+            file_put_contents(BUILD_ROOT_PATH . '/build-extensions.json', json_encode($extensions, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES));
+            file_put_contents(BUILD_ROOT_PATH . '/build-libraries.json', json_encode($libraries, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES));
+            // 导出 LICENSE
+            $dumper = new LicenseDumper();
+            $dumper->addExts($extensions)->addLibs($libraries)->addSources(['php-src'])->dump(BUILD_ROOT_PATH . '/license');
+            logger()->info('License path: ' . BUILD_ROOT_PATH . '/license/');
+            return 0;
+        } catch (WrongUsageException $e) {
+            logger()->critical($e->getMessage());
+            return 1;
+        } catch (\Throwable $e) {
+            if ($this->getOption('debug')) {
+                ExceptionHandler::getInstance()->handle($e);
+            } else {
+                logger()->critical('Build failed with ' . get_class($e) . ': ' . $e->getMessage());
+                logger()->critical('Please check with --debug option to see more details.');
+            }
+            return 1;
+        }
+    }
+}

src/SPC/command/BuildCommand.php

@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\command;
+
+use Symfony\Component\Console\Input\InputOption;
+
+abstract class BuildCommand extends BaseCommand
+{
+    public function __construct(string $name = null)
+    {
+        parent::__construct($name);
+
+        // 根据运行的操作系统分配允许不同的命令行参数，Windows 需要额外的 VS 和 SDK等，*nix 需要提供架构
+        switch (PHP_OS_FAMILY) {
+            case 'Windows':
+                $this->addOption('with-sdk-binary-dir', null, InputOption::VALUE_REQUIRED, 'path to binary sdk');
+                $this->addOption('vs-ver', null, InputOption::VALUE_REQUIRED, 'vs version, e.g. "17" for Visual Studio 2022');
+                $this->addOption('arch', null, InputOption::VALUE_REQUIRED, 'architecture, "x64" or "arm64"', 'x64');
+                break;
+            case 'Linux':
+                $this->addOption('no-system-static', null, null, 'do not use system static libraries');
+                // no break
+            case 'Darwin':
+                $this->addOption('cc', null, InputOption::VALUE_REQUIRED, 'C compiler');
+                $this->addOption('cxx', null, InputOption::VALUE_REQUIRED, 'C++ compiler');
+                $this->addOption('arch', null, InputOption::VALUE_REQUIRED, 'architecture', php_uname('m'));
+                break;
+        }
+
+        // 是否在编译 make 前清除旧的文件
+        $this->addOption('with-clean', null, null, 'fresh build, `make clean` before `make`');
+        // 是否采用强制链接，让链接器强制加载静态库文件
+        $this->addOption('bloat', null, null, 'add all libraries into binary');
+    }
+}

src/SPC/command/BuildLibsCommand.php

@@ -0,0 +1,77 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\command;
+
+use SPC\builder\BuilderProvider;
+use SPC\exception\ExceptionHandler;
+use SPC\exception\RuntimeException;
+use Symfony\Component\Console\Attribute\AsCommand;
+use Symfony\Component\Console\Input\InputArgument;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Output\OutputInterface;
+
+#[AsCommand('build:libs', 'Build dependencies')]
+class BuildLibsCommand extends BuildCommand
+{
+    public function configure()
+    {
+        $this->addArgument('libraries', InputArgument::REQUIRED, 'The libraries will be compiled, comma separated');
+        $this->addOption('clean', null, null, 'Clean old download cache and source before fetch');
+        $this->addOption('all', 'A', null, 'Build all libs that static-php-cli needed');
+    }
+
+    public function initialize(InputInterface $input, OutputInterface $output)
+    {
+        // --all 等于 ""
+        if ($input->getOption('all')) {
+            $input->setArgument('libraries', '');
+        }
+        parent::initialize($input, $output);
+    }
+
+    /**
+     * @throws RuntimeException
+     */
+    public function handle(): int
+    {
+        // 从参数中获取要编译的 libraries，并转换为数组
+        $libraries = array_map('trim', array_filter(explode(',', $this->getArgument('libraries'))));
+
+        // 删除旧资源
+        if ($this->getOption('clean')) {
+            logger()->warning('You are doing some operations that not recoverable: removing directories below');
+            logger()->warning(BUILD_ROOT_PATH);
+            logger()->warning('I will remove these dir after you press [Enter] !');
+            echo 'Confirm operation? [Yes] ';
+            fgets(STDIN);
+            if (PHP_OS_FAMILY === 'Windows') {
+                f_passthru('rmdir /s /q ' . BUILD_ROOT_PATH);
+            } else {
+                f_passthru('rm -rf ' . BUILD_ROOT_PATH);
+            }
+        }
+
+        try {
+            // 构建对象
+            $builder = BuilderProvider::makeBuilderByInput($this->input);
+            // 只编译 library 的情况下，标记
+            $builder->setLibsOnly();
+            // 编译和检查库完整
+            $builder->buildLibs($libraries);
+
+            $time = round(microtime(true) - START_TIME, 3);
+            logger()->info('Build libs complete, used ' . $time . ' s !');
+            return 0;
+        } catch (\Throwable $e) {
+            if ($this->getOption('debug')) {
+                ExceptionHandler::getInstance()->handle($e);
+            } else {
+                logger()->critical('Build failed with ' . get_class($e) . ': ' . $e->getMessage());
+                logger()->critical('Please check with --debug option to see more details.');
+            }
+            return 1;
+        }
+    }
+}

src/SPC/command/DeployCommand.php

@@ -0,0 +1,131 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\command;
+
+use CliHelper\Tools\ArgFixer;
+use CliHelper\Tools\DataProvider;
+use CliHelper\Tools\SeekableArrayIterator;
+use Symfony\Component\Console\Attribute\AsCommand;
+use Symfony\Component\Console\Helper\ProgressBar;
+use Symfony\Component\Console\Input\InputArgument;
+use Symfony\Component\Console\Input\InputOption;
+
+#[AsCommand('deploy', 'Deploy static-php-cli self to an .phar application')]
+class DeployCommand extends BaseCommand
+{
+    public function configure()
+    {
+        $this->addArgument('target', InputArgument::OPTIONAL, 'The file or directory to pack.');
+        $this->addOption('auto-phar-fix', null, InputOption::VALUE_NONE, 'Automatically fix ini option.');
+        $this->addOption('overwrite', 'W', InputOption::VALUE_NONE, 'Overwrite existing files.');
+    }
+
+    public function handle(): int
+    {
+        // 第一阶段流程：如果没有写path，将会提示输入要打包的path
+        $prompt = new ArgFixer($this->input, $this->output);
+        // 首先得确认是不是关闭了readonly模式
+        if (ini_get('phar.readonly') == 1) {
+            if ($this->getOption('auto-phar-fix')) {
+                $ask = true;
+            } else {
+                $ask = $prompt->requireBool('<comment>pack command needs "phar.readonly" = "Off" !</comment>' . PHP_EOL . 'If you want to automatically set it and continue, just Enter', true);
+            }
+            if ($ask) {
+                global $argv;
+                $args = array_merge(['-d', 'phar.readonly=0'], $_SERVER['argv']);
+                if (function_exists('pcntl_exec')) {
+                    $this->output->writeln('<info>Changing to phar.readonly=0 mode ...</info>');
+                    if (pcntl_exec(PHP_BINARY, $args) === false) {
+                        throw new \PharException('切换到读写模式失败，请检查环境。');
+                    }
+                } else {
+                    $this->output->writeln('<info>Now running command in child process.</info>');
+                    passthru(PHP_BINARY . ' -d phar.readonly=0 ' . implode(' ', $argv), $retcode);
+                    exit($retcode);
+                }
+            }
+        }
+        // 获取路径
+        $path = WORKING_DIR;
+        // 如果是目录，则将目录下的所有文件打包
+        $phar_path = $prompt->requireArgument('target', 'Please input the phar target filename', 'static-php-cli.phar');
+
+        if (DataProvider::isRelativePath($phar_path)) {
+            $phar_path = '/tmp/' . $phar_path;
+        }
+        if (file_exists($phar_path)) {
+            $ask = $this->getOption('overwrite') ? true : $prompt->requireBool('<comment>The file "' . $phar_path . '" already exists, do you want to overwrite it?</comment>' . PHP_EOL . 'If you want to, just Enter');
+            if (!$ask) {
+                $this->output->writeln('<comment>User canceled.</comment>');
+                return 1;
+            }
+            @unlink($phar_path);
+        }
+        $phar = new \Phar($phar_path);
+        $phar->startBuffering();
+
+        $all = DataProvider::scanDirFiles($path, true, true);
+
+        $all = array_filter($all, function ($x) {
+            $dirs = preg_match('/(^(config|src|vendor)\\/|^(composer\\.json|README\\.md|source\\.json|LICENSE|README-en\\.md)$)/', $x);
+            return !($dirs !== 1);
+        });
+        sort($all);
+        $map = [];
+        foreach ($all as $v) {
+            $map[$v] = $path . '/' . $v;
+        }
+
+        $this->output->writeln('<info>Start packing files...</info>');
+        try {
+            foreach ($this->progress()->iterate($map) as $file => $origin_file) {
+                $phar->addFromString($file, php_strip_whitespace($origin_file));
+            }
+            // $phar->buildFromIterator(new SeekableArrayIterator($map, new ProgressBar($output)));
+            $phar->addFromString(
+                '.phar-entry.php',
+                str_replace(
+                    '/../vendor/autoload.php',
+                    '/vendor/autoload.php',
+                    file_get_contents(ROOT_DIR . '/bin/spc')
+                )
+            );
+            $stub = '.phar-entry.php';
+            $phar->setStub($phar->createDefaultStub($stub));
+        } catch (\Throwable $e) {
+            $this->output->writeln($e);
+            return 1;
+        }
+        $phar->addFromString('.prod', 'true');
+        $phar->stopBuffering();
+        $this->output->writeln(PHP_EOL . 'Done! Phar file is generated at "' . $phar_path . '".');
+        if (file_exists(SOURCE_PATH . '/php-src/sapi/micro/micro.sfx')) {
+            $this->output->writeln('Detected you have already compiled micro binary, I will make executable now for you!');
+            file_put_contents(
+                pathinfo($phar_path, PATHINFO_DIRNAME) . '/spc',
+                file_get_contents(SOURCE_PATH . '/php-src/sapi/micro/micro.sfx') .
+                file_get_contents($phar_path)
+            );
+            chmod(pathinfo($phar_path, PATHINFO_DIRNAME) . '/spc', 0755);
+            $this->output->writeln('<info>Binary Executable: ' . pathinfo($phar_path, PATHINFO_DIRNAME) . '/spc</info>');
+        }
+        chmod($phar_path, 0755);
+        $this->output->writeln('<info>Phar Executable: ' . $phar_path . '</info>');
+        return 0;
+    }
+
+    private function progress(int $max = 0): ProgressBar
+    {
+        $progress = new ProgressBar($this->output, $max);
+        $progress->setBarCharacter('<fg=green>⚬</>');
+        $progress->setEmptyBarCharacter('<fg=red>⚬</>');
+        $progress->setProgressCharacter('<fg=green>➤</>');
+        $progress->setFormat(
+            "%current%/%max% [%bar%] %percent:3s%%\n🪅 %estimated:-20s%  %memory:20s%" . PHP_EOL
+        );
+        return $progress;
+    }
+}

src/SPC/command/DoctorCommand.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\command;
+
+use SPC\doctor\CheckListHandler;
+use Symfony\Component\Console\Attribute\AsCommand;
+
+#[AsCommand('doctor', 'Diagnose whether the current environment can compile normally')]
+class DoctorCommand extends BaseCommand
+{
+    public function handle(): int
+    {
+        try {
+            $checker = new CheckListHandler($this->input, $this->output);
+            $checker->runCheck(FIX_POLICY_PROMPT);
+            $this->output->writeln('<info>Doctor check complete !</info>');
+        } catch (\Throwable $e) {
+            $this->output->writeln('<error>' . $e->getMessage() . '</error>');
+            return 1;
+        }
+        return 0;
+    }
+}

src/SPC/command/DumpLicenseCommand.php

@@ -0,0 +1,73 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\command;
+
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
+use SPC\util\DependencyUtil;
+use SPC\util\LicenseDumper;
+use Symfony\Component\Console\Attribute\AsCommand;
+use Symfony\Component\Console\Input\InputOption;
+
+/**
+ * 修改 config 后对其 kv 进行排序的操作
+ */
+#[AsCommand('dump-license', 'Dump licenses for required libraries')]
+class DumpLicenseCommand extends BaseCommand
+{
+    public function configure()
+    {
+        $this->addOption('by-extensions', null, InputOption::VALUE_REQUIRED, 'Dump by extensions and related libraries', null);
+        $this->addOption('without-php', null, InputOption::VALUE_NONE, 'Dump without php-src');
+        $this->addOption('by-libs', null, InputOption::VALUE_REQUIRED, 'Dump by libraries', null);
+        $this->addOption('by-sources', null, InputOption::VALUE_REQUIRED, 'Dump by original sources (source.json)', null);
+        $this->addOption('dump-dir', null, InputOption::VALUE_REQUIRED, 'Change dump directory', BUILD_ROOT_PATH . '/license');
+    }
+
+    /**
+     * @throws WrongUsageException
+     * @throws FileSystemException
+     * @throws RuntimeException
+     */
+    public function handle(): int
+    {
+        $dumper = new LicenseDumper();
+        if ($this->getOption('by-extensions') !== null) {
+            // 从参数中获取要编译的 extensions，并转换为数组
+            $extensions = array_map('trim', array_filter(explode(',', $this->getOption('by-extensions'))));
+            // 根据提供的扩展列表获取依赖库列表并编译
+            [$extensions, $libraries, $not_included] = DependencyUtil::getExtLibsByDeps($extensions);
+            $dumper->addExts($extensions);
+            $dumper->addLibs($libraries);
+            if (!$this->getOption('without-php')) {
+                $dumper->addSources(['php-src']);
+            }
+            $dumper->dump($this->getOption('dump-dir'));
+            $this->output->writeln('Dump license with extensions: ' . implode(', ', $extensions));
+            $this->output->writeln('Dump license with libraries: ' . implode(', ', $libraries));
+            $this->output->writeln('Dump license with' . ($this->getOption('without-php') ? 'out' : '') . ' php-src');
+            $this->output->writeln('Dump target dir: ' . $this->getOption('dump-dir'));
+            return 0;
+        }
+        if ($this->getOption('by-libs') !== null) {
+            $libraries = array_map('trim', array_filter(explode(',', $this->getOption('by-libs'))));
+            $libraries = DependencyUtil::getLibsByDeps($libraries);
+            $dumper->addLibs($libraries);
+            $dumper->dump($this->getOption('dump-dir'));
+            $this->output->writeln('Dump target dir: ' . $this->getOption('dump-dir'));
+            return 0;
+        }
+        if ($this->getOption('by-sources') !== null) {
+            $sources = array_map('trim', array_filter(explode(',', $this->getOption('by-sources'))));
+            $dumper->addSources($sources);
+            $dumper->dump($this->getOption('dump-dir'));
+            $this->output->writeln('Dump target dir: ' . $this->getOption('dump-dir'));
+            return 0;
+        }
+        $this->output->writeln('You must use one of "--by-extensions=", "--by-libs=", "--by-sources=" to dump');
+        return 1;
+    }
+}

src/SPC/command/FetchSourceCommand.php

@@ -0,0 +1,234 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\command;
+
+use SPC\exception\DownloaderException;
+use SPC\exception\ExceptionHandler;
+use SPC\exception\FileSystemException;
+use SPC\exception\InvalidArgumentException;
+use SPC\exception\RuntimeException;
+use SPC\store\Config;
+use SPC\store\Downloader;
+use SPC\util\Patcher;
+use SPC\util\Util;
+use Symfony\Component\Console\Attribute\AsCommand;
+use Symfony\Component\Console\Input\InputArgument;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Input\InputOption;
+use Symfony\Component\Console\Output\OutputInterface;
+
+/** @noinspection PhpUnused */
+#[AsCommand('fetch', 'Fetch required sources')]
+class FetchSourceCommand extends BaseCommand
+{
+    protected string $php_major_ver;
+
+    public function configure()
+    {
+        $this->addArgument('extensions', InputArgument::REQUIRED, 'The extensions will be compiled, comma separated');
+        $this->addArgument('libraries', InputArgument::REQUIRED, 'The libraries will be compiled, comma separated');
+        $this->addOption('hash', null, null, 'Hash only');
+        $this->addOption('shallow-clone', null, null, 'Clone shallow');
+        $this->addOption('with-openssl11', null, null, 'Use openssl 1.1');
+        $this->addOption('with-php', null, InputOption::VALUE_REQUIRED, 'version in major.minor format like 8.1', '8.1');
+        $this->addOption('clean', null, null, 'Clean old download cache and source before fetch');
+        $this->addOption('all', 'A', null, 'Fetch all sources that static-php-cli needed');
+    }
+
+    public function initialize(InputInterface $input, OutputInterface $output)
+    {
+        // --all 等于 "" ""，也就是所有东西都要下载
+        if ($input->getOption('all')) {
+            $input->setArgument('extensions', '');
+            $input->setArgument('libraries', '');
+        }
+        parent::initialize($input, $output);
+    }
+
+    public function handle(): int
+    {
+        try {
+            // 匹配版本
+            $ver = $this->php_major_ver = $this->getOption('with-php') ?? '8.1';
+            define('SPC_BUILD_PHP_VERSION', $ver);
+            preg_match('/^\d+\.\d+$/', $ver, $matches);
+            if (!$matches) {
+                logger()->error("bad version arg: {$ver}, x.y required!");
+                return 1;
+            }
+
+            // 删除旧资源
+            if ($this->getOption('clean')) {
+                logger()->warning('You are doing some operations that not recoverable: removing directories below');
+                logger()->warning(SOURCE_PATH);
+                logger()->warning(DOWNLOAD_PATH);
+                logger()->warning('I will remove these dir after you press [Enter] !');
+                echo 'Confirm operation? [Yes] ';
+                $r = strtolower(trim(fgets(STDIN)));
+                if ($r !== 'yes' && $r !== '') {
+                    logger()->notice('Operation canceled.');
+                    return 1;
+                }
+                if (PHP_OS_FAMILY === 'Windows') {
+                    f_passthru('rmdir /s /q ' . SOURCE_PATH);
+                    f_passthru('rmdir /s /q ' . DOWNLOAD_PATH);
+                } else {
+                    f_passthru('rm -rf ' . SOURCE_PATH);
+                    f_passthru('rm -rf ' . DOWNLOAD_PATH);
+                }
+            }
+
+            // 使用浅克隆可以减少调用 git 命令下载资源时的存储空间占用
+            if ($this->getOption('shallow-clone')) {
+                define('GIT_SHALLOW_CLONE', true);
+            }
+
+            // 读取源配置，随便读一个source，用于缓存 source 配置
+            Config::getSource('openssl');
+
+            // 是否启用openssl11
+            if ($this->getOption('with-openssl11')) {
+                logger()->debug('Using openssl 1.1');
+                // 手动修改配置
+                Config::$source['openssl']['regex'] = '/href="(?<file>openssl-(?<version>1.[^"]+)\.tar\.gz)\"/';
+            }
+
+            // 默认预选 phpmicro
+            $chosen_sources = ['micro'];
+
+            // 从参数中获取要编译的 libraries，并转换为数组
+            $libraries = array_map('trim', array_filter(explode(',', $this->getArgument('libraries'))));
+            if ($libraries) {
+                foreach ($libraries as $lib) {
+                    // 从 lib 的 config 中找到对应 source 资源名称，组成一个 lib 的 source 列表
+                    $src_name = Config::getLib($lib, 'source');
+                    $chosen_sources[] = $src_name;
+                }
+            } else { // 如果传入了空串，那么代表 fetch 所有包
+                $chosen_sources = [...$chosen_sources, ...array_map(fn ($x) => $x['source'], array_values(Config::getLibs()))];
+            }
+
+            // 从参数中获取要编译的 extensions，并转换为数组
+            $extensions = array_map('trim', array_filter(explode(',', $this->getArgument('extensions'))));
+            if ($extensions) {
+                foreach ($extensions as $lib) {
+                    if (Config::getExt($lib, 'type') !== 'builtin') {
+                        $src_name = Config::getExt($lib, 'source');
+                        $chosen_sources[] = $src_name;
+                    }
+                }
+            } else {
+                foreach (Config::getExts() as $ext) {
+                    if ($ext['type'] !== 'builtin') {
+                        $chosen_sources[] = $ext['source'];
+                    }
+                }
+            }
+            $chosen_sources = array_unique($chosen_sources);
+
+            // 是否只hash，不下载资源
+            if ($this->getOption('hash')) {
+                $hash = $this->doHash($chosen_sources);
+                $this->output->writeln($hash);
+                return 0;
+            }
+
+            // 创建目录
+            f_mkdir(SOURCE_PATH);
+            f_mkdir(DOWNLOAD_PATH);
+
+            // 下载 PHP
+            array_unshift($chosen_sources, 'php-src');
+            // 下载别的依赖资源
+            $cnt = count($chosen_sources);
+            $ni = 0;
+            foreach ($chosen_sources as $name) {
+                ++$ni;
+                logger()->info("Fetching source {$name} [{$ni}/{$cnt}]");
+                Downloader::fetchSource($name, Config::getSource($name));
+            }
+
+            // patch 每份资源只需一次，如果已经下载好的资源已经patch了，就标记一下不patch了
+            if (!file_exists(SOURCE_PATH . '/.patched')) {
+                $this->doPatch();
+            } else {
+                logger()->notice('sources already patched');
+            }
+
+            // 打印拉取资源用时
+            $time = round(microtime(true) - START_TIME, 3);
+            logger()->info('Fetch complete, used ' . $time . ' s !');
+            return 0;
+        } catch (\Throwable $e) {
+            // 不开 debug 模式就不要再显示复杂的调试栈信息了
+            if ($this->getOption('debug')) {
+                ExceptionHandler::getInstance()->handle($e);
+            } else {
+                logger()->emergency($e->getMessage() . ', previous message: ' . $e->getPrevious()?->getMessage());
+            }
+            return 1;
+        }
+    }
+
+    /**
+     * 计算资源名称列表的 Hash
+     *
+     * @param  array                    $chosen_sources 要计算 hash 的资源名称列表
+     * @throws InvalidArgumentException
+     * @throws DownloaderException
+     * @throws FileSystemException
+     */
+    private function doHash(array $chosen_sources): string
+    {
+        $files = [];
+        foreach ($chosen_sources as $name) {
+            $source = Config::getSource($name);
+            $filename = match ($source['type']) {
+                'ghtar' => Downloader::getLatestGithubTarball($name, $source)[1],
+                'ghtagtar' => Downloader::getLatestGithubTarball($name, $source, 'tags')[1],
+                'ghrel' => Downloader::getLatestGithubRelease($name, $source)[1],
+                'filelist' => Downloader::getFromFileList($name, $source)[1],
+                'url' => $source['filename'] ?? basename($source['url']),
+                'git' => null,
+                default => throw new InvalidArgumentException('unknown source type: ' . $source['type']),
+            };
+            if ($filename !== null) {
+                logger()->info("found {$name} source: {$filename}");
+                $files[] = $filename;
+            }
+        }
+        return hash('sha256', implode('|', $files));
+    }
+
+    /**
+     * 在拉回资源后，需要对一些文件做一些补丁 patch
+     *
+     * @throws FileSystemException
+     * @throws RuntimeException
+     */
+    private function doPatch(): void
+    {
+        // swow 需要软链接内部的文件夹才能正常编译
+        if (!file_exists(SOURCE_PATH . '/php-src/ext/swow') && Util::getPHPVersionID() >= 80000) {
+            Patcher::patchSwow();
+            // patch 一些 PHP 的资源，以便编译
+            Patcher::patchMicroThings();
+        }
+
+        // openssl 3 需要 patch 额外的东西
+        if (!$this->input->getOption('with-openssl11') && $this->php_major_ver === '8.0') {
+            Patcher::patchOpenssl3();
+        }
+
+        // openssl1.1.1q 在 MacOS 上直接编译会报错，patch 一下
+        // @see: https://github.com/openssl/openssl/issues/18720
+        if ($this->input->getOption('with-openssl11') && file_exists(SOURCE_PATH . '/openssl/test/v3ext.c') && PHP_OS_FAMILY === 'Darwin') {
+            Patcher::patchDarwinOpenssl11();
+        }
+
+        // 标记 patch 完成，避免重复 patch
+        file_put_contents(SOURCE_PATH . '/.patched', '');
+    }
+}

src/SPC/command/ListExtCommand.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\command;
+
+use SPC\exception\FileSystemException;
+use SPC\store\Config;
+use Symfony\Component\Console\Attribute\AsCommand;
+
+#[AsCommand('list-ext', 'List supported extensions')]
+class ListExtCommand extends BaseCommand
+{
+    protected bool $no_motd = true;
+
+    /**
+     * @throws FileSystemException
+     */
+    public function handle(): int
+    {
+        foreach (Config::getExts() as $ext => $meta) {
+            echo $ext . PHP_EOL;
+        }
+        return 0;
+    }
+}