Add PECL download type and support for PECL artifacts

This commit is contained in:
crazywhalecc 2026-02-28 17:07:24 +08:00 committed by Jerry Ma
parent 174ef3dba7
commit dc0a80975f
14 changed files with 130 additions and 45 deletions

View File

@ -10,6 +10,7 @@ use StaticPHP\Artifact\Downloader\Type\GitHubRelease;
use StaticPHP\Artifact\Downloader\Type\GitHubTarball;
use StaticPHP\Artifact\Downloader\Type\HostedPackageBin;
use StaticPHP\Artifact\Downloader\Type\LocalDir;
use StaticPHP\Artifact\Downloader\Type\PECL;
use StaticPHP\Artifact\Downloader\Type\PhpRelease;
use StaticPHP\Artifact\Downloader\Type\PIE;
use StaticPHP\Artifact\Downloader\Type\Url;
@ -24,6 +25,7 @@ return [
'ghtagtar' => GitHubTarball::class,
'local' => LocalDir::class,
'pie' => PIE::class,
'pecl' => PECL::class,
'url' => Url::class,
'php-release' => PhpRelease::class,
'hosted' => HostedPackageBin::class,

View File

@ -1,5 +1,19 @@
ext-bcmath:
type: php-extension
ext-mbregex:
type: php-extension
depends:
- onig
- ext-mbstring
php-extension:
arg-type: custom
build-shared: false
build-static: true
display-name: mbstring
ext-mbstring:
type: php-extension
php-extension:
arg-type: custom
ext-openssl:
type: php-extension
depends:
@ -10,6 +24,21 @@ ext-openssl:
arg-type: custom
arg-type@windows: with
build-with-php: true
ext-phar:
type: php-extension
depends:
- zlib
ext-readline:
type: php-extension
depends:
- libedit
php-extension:
support:
Windows: wip
BSD: wip
arg-type: with-path
build-shared: false
build-static: true
ext-zlib:
type: php-extension
depends:

View File

@ -2,10 +2,8 @@ ext-amqp:
type: php-extension
artifact:
source:
type: url
url: 'https://pecl.php.net/get/amqp'
extract: php-src/ext/amqp
filename: amqp.tgz
type: pecl
name: amqp
metadata:
license-files: [LICENSE]
license: PHP-3.01

View File

@ -2,10 +2,8 @@ ext-apcu:
type: php-extension
artifact:
source:
type: url
url: 'https://pecl.php.net/get/APCu'
extract: php-src/ext/apcu
filename: apcu.tgz
type: pecl
name: APCu
metadata:
license-files: [LICENSE]
license: PHP-3.01

View File

@ -0,0 +1,6 @@
ext-ast:
type: php-extension
artifact:
source:
type: pecl
name: ast

View File

@ -1,10 +0,0 @@
ext-mbregex:
type: php-extension
depends:
- onig
- ext-mbstring
php-extension:
arg-type: custom
build-shared: false
build-static: true
display-name: mbstring

View File

@ -1,4 +0,0 @@
ext-mbstring:
type: php-extension
php-extension:
arg-type: custom

View File

@ -1,4 +0,0 @@
ext-phar:
type: php-extension
depends:
- zlib

View File

@ -1,11 +0,0 @@
ext-readline:
type: php-extension
depends:
- libedit
php-extension:
support:
Windows: wip
BSD: wip
arg-type: with-path
build-shared: false
build-static: true

View File

@ -163,7 +163,7 @@ class ArtifactCache
throw new SPCInternalException("Invalid lock type '{$lock_type}' for artifact {$artifact_name}");
}
// save cache to file
file_put_contents($this->cache_file, json_encode($this->cache, JSON_PRETTY_PRINT));
file_put_contents($this->cache_file, json_encode($this->cache, JSON_UNESCAPED_SLASHES | JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE));
}
/**
@ -281,7 +281,7 @@ class ArtifactCache
*/
public function save(): void
{
file_put_contents($this->cache_file, json_encode($this->cache, JSON_PRETTY_PRINT));
file_put_contents($this->cache_file, json_encode($this->cache, JSON_UNESCAPED_SLASHES | JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE));
}
private function isObjectDownloaded(?array $object, bool $compare_hash = false): bool

View File

@ -22,7 +22,7 @@ class Git implements DownloadTypeInterface, CheckUpdateInterface
if (isset($config['rev'])) {
default_shell()->executeGitClone($config['url'], $config['rev'], $path, $shallow, $config['submodules'] ?? null);
$shell = PHP_OS_FAMILY === 'Windows' ? cmd(false) : shell(false);
$hash_result = $shell->execWithResult(SPC_GIT_EXEC . ' -C ' . escapeshellarg($path) . ' rev-parse HEAD');
$hash_result = $shell->execWithResult(SPC_GIT_EXEC . ' -C ' . escapeshellarg($path) . ' rev-parse --short HEAD');
$hash = ($hash_result[0] === 0 && !empty($hash_result[1])) ? trim($hash_result[1][0]) : '';
$version = $hash !== '' ? "dev-{$config['rev']}+{$hash}" : "dev-{$config['rev']}";
return DownloadResult::git($name, $config, extract: $config['extract'] ?? null, version: $version, downloader: static::class);
@ -80,7 +80,7 @@ class Git implements DownloadTypeInterface, CheckUpdateInterface
if ($result[0] !== 0 || empty($result[1])) {
throw new DownloaderException("Failed to ls-remote from {$config['url']}");
}
$new_hash = substr($result[1][0], 0, 40);
$new_hash = substr($result[1][0], 0, 7);
$new_version = "dev-{$config['rev']}+{$new_hash}";
// Extract stored hash from "dev-{rev}+{hash}", null if bare mode or old format without hash
$old_hash = ($old_version !== null && str_contains($old_version, '+')) ? substr(strrchr($old_version, '+'), 1) : null;

View File

@ -0,0 +1,79 @@
<?php
declare(strict_types=1);
namespace StaticPHP\Artifact\Downloader\Type;
use StaticPHP\Artifact\ArtifactDownloader;
use StaticPHP\Artifact\Downloader\DownloadResult;
use StaticPHP\Exception\DownloaderException;
/* pecl */
class PECL implements DownloadTypeInterface, CheckUpdateInterface
{
private const string PECL_BASE_URL = 'https://pecl.php.net';
/** REST API: returns XML with <r><v>VERSION</v><s>STATE</s></r> per release */
private const string PECL_REST_URL = 'https://pecl.php.net/rest/r/%s/allreleases.xml';
public function checkUpdate(string $name, array $config, ?string $old_version, ArtifactDownloader $downloader): CheckUpdateResult
{
[, $version] = $this->fetchPECLInfo($name, $config, $downloader);
return new CheckUpdateResult(
old: $old_version,
new: $version,
needUpdate: $old_version === null || version_compare($version, $old_version, '>'),
);
}
public function download(string $name, array $config, ArtifactDownloader $downloader): DownloadResult
{
[$filename, $version] = $this->fetchPECLInfo($name, $config, $downloader);
$url = self::PECL_BASE_URL . '/get/' . $filename;
$path = DOWNLOAD_PATH . DIRECTORY_SEPARATOR . $filename;
logger()->debug("Downloading {$name} from URL: {$url}");
default_shell()->executeCurlDownload($url, $path, retries: $downloader->getRetry());
$extract = $config['extract'] ?? ('php-src/ext/' . $this->getExtractName($name));
return DownloadResult::archive($filename, $config, $extract, version: $version, downloader: static::class);
}
protected function fetchPECLInfo(string $name, array $config, ArtifactDownloader $downloader): array
{
$peclName = strtolower($config['name'] ?? $this->getExtractName($name));
$url = sprintf(self::PECL_REST_URL, $peclName);
logger()->debug("Fetching PECL release list for {$name} from REST API");
$xml = default_shell()->executeCurl($url, retries: $downloader->getRetry());
if ($xml === false) {
throw new DownloaderException("Failed to fetch PECL release list for {$name}");
}
// Match <r><v>VERSION</v><s>STATE</s></r>
preg_match_all('/<r><v>(?P<version>[^<]+)<\/v><s>(?P<state>[^<]+)<\/s><\/r>/', $xml, $matches);
if (empty($matches['version'])) {
throw new DownloaderException("Failed to parse PECL release list for {$name}");
}
$versions = [];
logger()->debug('Matched ' . count($matches['version']) . " releases for {$name} from PECL");
foreach ($matches['version'] as $i => $version) {
if ($matches['state'][$i] !== 'stable') {
continue;
}
$versions[$version] = $peclName . '-' . $version . '.tgz';
}
if (empty($versions)) {
throw new DownloaderException("No stable releases found for {$name} on PECL");
}
uksort($versions, 'version_compare');
$filename = end($versions);
$version = array_key_last($versions);
return [$filename, $version, $versions];
}
/**
* Derive the lowercase PECL package / extract name from the artifact name.
* e.g. "ext-apcu" -> "apcu", "ext-ast" -> "ast"
*/
private function getExtractName(string $name): string
{
return strtolower(preg_replace('/^ext-/i', '', $name));
}
}

View File

@ -89,6 +89,7 @@ class ConfigValidator
'bitbuckettag' => [['repo'], ['extract']],
'local' => [['dirname'], ['extract']],
'pie' => [['repo'], ['extract']],
'pecl' => [['name'], ['extract']],
'php-release' => [[], ['extract']],
'custom' => [[], ['func']],
];

View File

@ -25,7 +25,7 @@ class DefaultShell extends Shell
/**
* Execute a cURL command to fetch data from a URL.
*/
public function executeCurl(string $url, string $method = 'GET', array $headers = [], array $hooks = [], int $retries = 0): false|string
public function executeCurl(string $url, string $method = 'GET', array $headers = [], array $hooks = [], int $retries = 0, bool $compressed = false): false|string
{
foreach ($hooks as $hook) {
$hook($method, $url, $headers);
@ -39,7 +39,8 @@ class DefaultShell extends Shell
};
$header_arg = implode(' ', array_map(fn ($v) => '"-H' . $v . '"', $headers));
$retry_arg = $retries > 0 ? "--retry {$retries}" : '';
$cmd = SPC_CURL_EXEC . " -sfSL {$retry_arg} {$method_arg} {$header_arg} {$url_arg}";
$compressed_arg = $compressed ? '--compressed' : '';
$cmd = SPC_CURL_EXEC . " -sfSL --max-time 3600 {$retry_arg} {$compressed_arg} {$method_arg} {$header_arg} {$url_arg}";
$this->logCommandInfo($cmd);
$result = $this->passthru($cmd, capture_output: true, throw_on_error: false);
@ -72,7 +73,7 @@ class DefaultShell extends Shell
$header_arg = implode(' ', array_map(fn ($v) => '"-H' . $v . '"', $headers));
$retry_arg = $retries > 0 ? "--retry {$retries}" : '';
$check = $this->console_putput ? '#' : 's';
$cmd = clean_spaces(SPC_CURL_EXEC . " -{$check}fSL {$retry_arg} {$header_arg} -o {$path_arg} {$url_arg}");
$cmd = clean_spaces(SPC_CURL_EXEC . " -{$check}fSL --max-time 3600 {$retry_arg} {$header_arg} -o {$path_arg} {$url_arg}");
$this->logCommandInfo($cmd);
logger()->debug('[CURL DOWNLOAD] ' . $cmd);
$this->passthru($cmd, $this->console_putput, capture_output: false, throw_on_error: true);
@ -93,7 +94,7 @@ class DefaultShell extends Shell
$path_arg = escapeshellarg($path);
$shallow_arg = $shallow ? '--depth 1 --single-branch' : '';
$submodules_arg = ($submodules === null && $shallow) ? '--recursive --shallow-submodules' : ($submodules === null ? '--recursive' : '');
$cmd = clean_spaces("{$git} clone --config core.autocrlf=false --branch {$branch_arg} {$shallow_arg} {$submodules_arg} {$url_arg} {$path_arg}");
$cmd = clean_spaces("{$git} clone -c http.lowSpeedLimit=1 -c http.lowSpeedTime=3600 --config core.autocrlf=false --branch {$branch_arg} {$shallow_arg} {$submodules_arg} {$url_arg} {$path_arg}");
$this->logCommandInfo($cmd);
logger()->debug("[GIT CLONE] {$cmd}");
$this->passthru($cmd, $this->console_putput);