Skip to content

StaticPHP v3 #980

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Draft
crazywhalecc wants to merge 58 commits into
base: v3
Choose a base branch
from
Draft

StaticPHP v3 #980

crazywhalecc wants to merge 58 commits into from

Conversation

@crazywhalecc
Copy link
Owner

@crazywhalecc crazywhalecc commented Nov 30, 2025 •
edited
Loading

Important notes

STATUS: dev -> alpha -> beta -> rc -> stable

Contribution notes:

  • Before we released the first alpha version, any changes should be merged into v3-dev, not v3.
  • After we released the first alpha version, any changes should be merged into v3 and we will deprecate v3-dev branch.
  • The structure of StaticPHP v3 may be changed before beta version.
  • Publishing new RFC is welcome.

RFCs

Progress of refactoring

bin/ refactoring

  • bin/spc for v3
  • bin/spc-alpine-docker
  • bin/spc-gnu-docker
  • bin/docker-entrypoint.sh
  • bin/setup-runtime

v3 new modules

  • Registry module loading for all configs and packages (StaticPHP v3 #980)
  • Vendor mode support
    • Separate a dedicated bootstrap file for initialization (StaticPHP v3 #980) (src/bootstrap.php)
    • Add init-registry command for vendor user

Commands refactoring

  • ConsoleApplication dynamic generating commands for target type packages (StaticPHP v3 #980)

  • Custom commands in external registry (StaticPHP v3 #980)

  • DownloadCommand

  • BaseCommand

  • BuildLibsCommand

  • BuildPHPCommand -> BuildTargetCommand with php package

    • Options
      • --with-libs: Keep for compatibility, add --with-packages option (StaticPHP v3 #980)
      • --build-shared
      • --build-all: Special parsing in v3 (StaticPHP v3 #980)
      • --no-strip, --disable-opcache-jit, --build-{sapi}, --with-config-file-path, --with-config-file-scan-dir, --with-hardcoded-ini, --with-micro-fake-cli, --with-added-patch (-P), --without-micro-ext-test, --with-upx-pack, --with-micro-logo, --enable-micro-win32, --with-frankenphp-app has been moved to php package definition (StaticPHP v3 #980)
      • Implementation status
        • no-strip
        • disable-opcache-jit
        • with-config-file-path
        • with-config-file-scan-dir
        • with-hardcoded-ini
        • with-micro-fake-cli
        • with-addeed-patch
        • without-micro-ext-test
        • with-upx-pack
        • with-micro-logo
        • enable-micro-win32
        • with-frankenphp-app
        • build-shared
        • with-packages (with-libs)
        • build-all
        • build-{sapi} except build-frankenphp (StaticPHP v3 #980)
        • build-frankenphp
        • with-suggests (with-suggested-libs, with-suggested-exts)
        • no-download (StaticPHP v3 #980)
        • Download options in build command (StaticPHP v3 #980)
        • with-clean
    • Build information printing: refactored to attribute #[StaticPHP\Attribute\Package\Info] (StaticPHP v3 #980)
    • Bind build extra info to ExceptionHandler
    • Validate packages before building and after extracting (StaticPHP v3 #980)
    • Patch static-php-cli version to PHP has been moved to php package build stage before (StaticPHP v3 #980)
    • Display build PHP result in terminal
    • Export licenses and build extensions and lib info after building

  • CraftCommand

  • DeleteDownloadCommand

  • DoctorCommand (StaticPHP v3 #980) (Just command, not Doctor items)

  • DumpExtensionsCommand

  • DumpLicenseCommand

  • ExtractCommand (Just command, not Extractor)

  • InstallPkgCommand ->InstallPackageCommand

    • PackageInstaller calling
    • Options
      • skip-extract

  • MicroCombineCommand

  • SPCConfigCommand

    • SPCConfigUtil calling
    • Options

  • SwitchPhpVersionCommand

  • Dev commands

    • AllExtCommand
    • EnvCommand
    • ExtVerCommand
    • GenerateExtDepDocsCommand
    • GenerateExtDocCommand
    • GenerateLibDepDocsCommand
    • LibVerCommand
    • PackLibCommand
    • PhpVerCommand
    • SortConfigCommand

Doctor module

  • Core framework refactored (StaticPHP v3 #980)
    • Doctor main class
    • DoctorLoader for loading check items
    • CheckResult for storing check results
    • Attribute-based check system: #[CheckItem], #[OptionalCheck], #[FixItem]
  • Doctor check items
    • OSCheck (migrated from v2's OSCheckList)
    • Re2cVersionCheck
    • PkgConfigCheck
    • MacOSToolCheck (migrated from v2's MacOSToolCheckList)
    • LinuxMuslCheck
    • LinuxToolCheck (v2 has LinuxToolCheckList)
    • BSDToolCheck (v2 has BSDToolCheckList)
    • WindowsToolCheck (v2 has WindowsToolCheckList)
    • ZigCheck (v2 has ZigCheck)

Legacy modules (v2 only - SPC namespace)

These modules exist in v2 but are refactored/merged into new v3 modules:

  • store/ - Deprecated and refactored
    • Downloader → StaticPHP\Artifact\ArtifactDownloader
    • LockFile → StaticPHP\Artifact\ArtifactCache
    • CurlHook → Merged into StaticPHP\Artifact\ArtifactDownloader
    • FileSystem → StaticPHP\Util\FileSystem
    • DirDiff → StaticPHP\Util\DirDiff
    • SourcePatcher → StaticPHP\Util\SourcePatcher (partial)
    • PackageManager, SourceManager → Removed (functionality in new Package/Artifact systems)
    • pkg/ → Migrated to src/Package/
    • source/ → Migrated to Artifact system

@crazywhalecc crazywhalecc added the mixed PR This PR contains multiple updates label Nov 30, 2025
henderkes and others added 6 commits November 30, 2025 16:08
@henderkes
Fix cross-device warning in rename function (#978)
6b3b841
@henderkes
add pcov extension (shared only, like xdebug) (#979)
59a6e27
@crazywhalecc
Merge branch 'main' into v3-dev
9903c22
@crazywhalecc
Forward-port #978
c38f174
@crazywhalecc
Add DirDiff utility and enhance package build process
daa87e1 
- Introduced DirDiff class for tracking directory file changes.
- Updated ConsoleApplication to use addCommand for build targets.
- Enhanced PackageBuilder with methods for deploying binaries and extracting debug info.
- Improved package installation logic to support shared extensions.
- Added readline extension with patching for static builds.
@crazywhalecc
cs fix
71d803d
@crazywhalecc crazywhalecc mentioned this pull request Dec 4, 2025
Open
@crazywhalecc crazywhalecc self-assigned this Dec 4, 2025
@crazywhalecc crazywhalecc mentioned this pull request Dec 4, 2025
Open
@crazywhalecc crazywhalecc mentioned this pull request Dec 6, 2025
Closed
henderkes
henderkes reviewed Dec 6, 2025
View reviewed changes
crazywhalecc and others added 30 commits December 8, 2025 11:06
@crazywhalecc
Fix wrong namespace in go-xcaddy package
3ff762c
@crazywhalecc
Allow absolute paths for configs
df6c27c
@crazywhalecc
Add PackageInstaller::isPackageInstalled() API
abd6c2f
@crazywhalecc
Remove redundant path
eab1059
@crazywhalecc
Refactor BUILDROOT_ABS initialization to provide a default path (#991)
127c935
@crazywhalecc
Refactor re2c fix-item
a1cadec
@crazywhalecc
Use patch for current package exclusively
80d922a
@crazywhalecc
Add libedit package build
20e0711
@crazywhalecc
Add ncurses package build
11e7a59
@crazywhalecc
Allow all types of package can be built
321f2e1
@crazywhalecc
Fix ncurses static-libs
f4bb026
@crazywhalecc
Add php-micro patch for embed mode
b384345
@crazywhalecc
Add patch description display
80128ed
@crazywhalecc
Add missing patchPkgconfPrefix function
78234ef
@crazywhalecc
Allow package implementation using parent class functions
7b16f68
@crazywhalecc
Add shared extension build support
a4bd2a7
@crazywhalecc
Correct SAPI-packages to be installed
0db26be
@crazywhalecc
Fix phpstan
e004d10
@crazywhalecc
Refactor package stage handling and update class structures for impro…
808aed2 
…ved flexibility
@crazywhalecc
Refactor stage execution to use method references for improved clarity
ac01867
@crazywhalecc
Add package outputs, colorize motd
b0f630f
@crazywhalecc
Support full --no-ansi options
bcaef59
@crazywhalecc
Update src/Package/Library/ncurses.php
4a96875 
Co-authored-by: Copilot <[email protected]>
@crazywhalecc
Update src/Package/Target/php.php
f68adc3 
Co-authored-by: Copilot <[email protected]>
@crazywhalecc
V3 feat/re2c (#992)
7837563 
Co-authored-by: Copilot <[email protected]>
@crazywhalecc
Refactor test structure and update paths for improved organization
bde1440
@crazywhalecc
Refactor test structure and update paths for improved organization (#995
97e337c 
)
@crazywhalecc
Add early validation for package build and installation requirements
794d92c
@crazywhalecc
Update ApplicationContext and InteractiveTerm to handle null outputs …
2901d32 
…gracefully
@crazywhalecc
Add early validation for package build and installation requirements (#…
66d3af5 
…996)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@henderkes henderkes henderkes left review comments

Assignees

@crazywhalecc crazywhalecc

Labels

mixed PR This PR contains multiple updates

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@crazywhalecc @henderkes