PHP Composer 依赖管理完整指南 入门到精通 ​

// src/Logger/FileLogger.php
<?php

namespace MyCompany\Logger;

use Psr\Log\LoggerInterface;
use Psr\Log\LogLevel;
use Psr\Log\LoggerTrait;

class FileLogger implements LoggerInterface
{
    use LoggerTrait;

    private string $logFile;

    public function __construct(string $logFile)
    {
        $this->logFile = $logFile;
    }

    public function log($level, $message, array $context = []): void
    {
        $timestamp = date('Y-m-d H:i:s');
        $contextStr = !empty($context) ? json_encode($context) : '';
        $logEntry = "[$timestamp] $level: $message $contextStr" . PHP_EOL;

        file_put_contents($this->logFile, $logEntry, FILE_APPEND | LOCK_EX);
    }
}

// src/CustomAutoloader.php
class CustomAutoloader
{
    private array $prefixes = [];

    public function register(): void
    {
        spl_autoload_register([$this, 'loadClass']);
    }

    public function addNamespace(string $prefix, string $baseDir): void
    {
        $prefix = trim($prefix, '\\') . '\\';
        $baseDir = rtrim($baseDir, DIRECTORY_SEPARATOR) . '/';

        if (!isset($this->prefixes[$prefix])) {
            $this->prefixes[$prefix] = [];
        }

        array_push($this->prefixes[$prefix], $baseDir);
    }

    public function loadClass(string $class): ?string
    {
        $prefix = $class;

        while (false !== $pos = strrpos($prefix, '\\')) {
            $prefix = substr($class, 0, $pos + 1);
            $relativeClass = substr($class, $pos + 1);

            $mappedFile = $this->loadMappedFile($prefix, $relativeClass);
            if ($mappedFile) {
                return $mappedFile;
            }

            $prefix = rtrim($prefix, '\\');
        }

        return null;
    }

    private function loadMappedFile(string $prefix, string $relativeClass): ?string
    {
        if (!isset($this->prefixes[$prefix])) {
            return null;
        }

        foreach ($this->prefixes[$prefix] as $baseDir) {
            $file = $baseDir . str_replace('\\', '/', $relativeClass) . '.php';

            if ($this->requireFile($file)) {
                return $file;
            }
        }

        return null;
    }

    private function requireFile(string $file): bool
    {
        if (file_exists($file)) {
            require $file;
            return true;
        }

        return false;
    }
}

// src/MyPlugin.php
<?php

namespace MyCompany\ComposerPlugin;

use Composer\Composer;
use Composer\IO\IOInterface;
use Composer\Plugin\PluginInterface;
use Composer\EventDispatcher\EventSubscriberInterface;
use Composer\Script\Event;
use Composer\Script\ScriptEvents;

class MyPlugin implements PluginInterface, EventSubscriberInterface
{
    public function activate(Composer $composer, IOInterface $io): void
    {
        $io->write('MyPlugin 已激活');
    }

    public function deactivate(Composer $composer, IOInterface $io): void
    {
        $io->write('MyPlugin 已停用');
    }

    public function uninstall(Composer $composer, IOInterface $io): void
    {
        $io->write('MyPlugin 已卸载');
    }

    public static function getSubscribedEvents(): array
    {
        return [
            ScriptEvents::POST_INSTALL_CMD => 'onPostInstall',
            ScriptEvents::POST_UPDATE_CMD => 'onPostUpdate',
        ];
    }

    public function onPostInstall(Event $event): void
    {
        $event->getIO()->write('安装后钩子已执行');
        $this->performCustomActions($event);
    }

    public function onPostUpdate(Event $event): void
    {
        $event->getIO()->write('更新后钩子已执行');
        $this->performCustomActions($event);
    }

    private function performCustomActions(Event $event): void
    {
        // 自定义插件逻辑
        $composer = $event->getComposer();
        $io = $event->getIO();

        // 访问包信息
        $packages = $composer->getRepositoryManager()->getLocalRepository()->getPackages();

        foreach ($packages as $package) {
            if ($package->getName() === 'mycompany/special-package') {
                $io->write('发现特殊包，执行操作...');
                // 执行特殊操作
            }
        }
    }
}

// 调试 Composer 问题
class ComposerDebugger
{
    public function checkComposerHealth(): void
    {
        echo "Composer 健康检查\n";
        echo str_repeat("=", 50) . "\n";

        $this->checkComposerVersion();
        $this->checkPHPVersion();
        $this->checkMemoryLimit();
        $this->checkWritePermissions();
        $this->checkLockFileIntegrity();
    }

    private function checkComposerVersion(): void
    {
        $version = $this->getComposerVersion();
        echo "Composer 版本: $version\n";

        if (version_compare($version, '2.0.0', '<')) {
            echo "⚠️  建议升级到 Composer 2.x 以获得更好性能\n";
        } else {
            echo "✅ Composer 版本是最新的\n";
        }
    }

    private function checkPHPVersion(): void
    {
        $phpVersion = PHP_VERSION;
        echo "PHP 版本: $phpVersion\n";

        if (version_compare($phpVersion, '8.1.0', '<')) {
            echo "⚠️  建议升级到 PHP 8.1+ 以获得更好性能\n";
        } else {
            echo "✅ PHP 版本是最新的\n";
        }
    }

    private function checkMemoryLimit(): void
    {
        $memoryLimit = ini_get('memory_limit');
        echo "内存限制: $memoryLimit\n";

        $memoryInBytes = $this->convertToBytes($memoryLimit);
        if ($memoryInBytes < 512 * 1024 * 1024) { // 512MB
            echo "⚠️  建议将 memory_limit 增加到 512M 或更高\n";
        } else {
            echo "✅ 内存限制足够\n";
        }
    }

    private function checkWritePermissions(): void
    {
        $vendorDir = getcwd() . '/vendor';

        if (!is_dir($vendorDir)) {
            echo "📁 vendor 目录不存在（首次安装时正常）\n";
            return;
        }

        if (!is_writable($vendorDir)) {
            echo "❌ vendor 目录不可写\n";
        } else {
            echo "✅ vendor 目录可写\n";
        }
    }

    private function checkLockFileIntegrity(): void
    {
        $lockFile = getcwd() . '/composer.lock';

        if (!file_exists($lockFile)) {
            echo "⚠️  未找到 composer.lock 文件\n";
            return;
        }

        $lockContent = file_get_contents($lockFile);
        $lockData = json_decode($lockContent, true);

        if (!$lockData) {
            echo "❌ composer.lock 文件已损坏\n";
        } else {
            echo "✅ composer.lock 文件有效\n";
        }
    }

    private function getComposerVersion(): string
    {
        $output = shell_exec('composer --version 2>/dev/null');
        preg_match('/(\d+\.\d+\.\d+)/', $output, $matches);
        return $matches[1] ?? 'Unknown';
    }

    private function convertToBytes(string $size): int
    {
        $unit = strtolower(substr($size, -1));
        $value = (int) substr($size, 0, -1);

        switch ($unit) {
            case 'g':
                return $value * 1024 * 1024 * 1024;
            case 'm':
                return $value * 1024 * 1024;
            case 'k':
                return $value * 1024;
            default:
                return (int) $size;
        }
    }
}

// 运行健康检查
$debugger = new ComposerDebugger();
$debugger->checkComposerHealth();