基于Composer与依赖库的PHP单文件应用部署问题求助

嘿，我之前也碰到过类似的Phar和Symfony路由冲突的问题，给你几个经过验证的可行方案，应该能帮你搞定：

方案1：自定义Phar Stub处理HTTP路由 #

默认的Phar Stub在Web环境下会直接跳转到预设的入口文件（比如www/index.php），无法适配Symfony的动态路由规则。我们可以自定义Stub来捕获请求URI，动态映射到Phar内部的文件：

#!/usr/bin/env php
<?php
Phar::mapPhar('app.phar');

if (php_sapi_name() !== 'cli') {
    // 获取请求路径，剔除查询参数
    $requestUri = $_SERVER['REQUEST_URI'];
    $path = parse_url($requestUri, PHP_URL_PATH);
    $internalPath = rtrim(ltrim($path, '/'), '/') ?: 'index.php';

    // 检查Phar内部是否存在该文件，不存在则交给Symfony入口处理
    if (!Phar::isFile("phar://app.phar/{$internalPath}")) {
        $internalPath = 'index.php';
    }

    require "phar://app.phar/{$internalPath}";
} else {
    // CLI模式下的默认入口
    require 'phar://app.phar/index.php';
}

__HALT_COMPILER();

这个Stub的核心逻辑是：

• 拦截Web请求的URI，解析出实际路径
• 优先匹配Phar内部的静态文件（如css、js）
• 如果路径不存在，自动回退到Symfony的index.php，让Symfony路由系统处理动态请求

方案2：调整Symfony的.htaccess重写规则 #

原来的Symfony 3 .htaccess是指向web/index.php，现在需要修改为指向你重命名后的Phar文件（比如app.php），确保所有动态请求都转发到单文件应用：

<IfModule mod_rewrite.c>
    RewriteEngine On

    # 直接存在的静态文件/目录直接访问
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d

    # 所有其他请求转发到app.php（你的Phar重命名文件）
    RewriteRule ^(.*)$ app.php [QSA,L]
</IfModule>

注意：确保app.php放置在Web根目录（或你对应的部署目录），并且服务器开启了mod_rewrite模块。

方案3：使用Phar内置的webPhar()方法 #

Phar提供了专门用于Web环境的webPhar()方法，它可以自动处理URL路由和404回退，代码更简洁：

#!/usr/bin/env php
<?php
Phar::webPhar(
    'app.phar',
    'index.php', // 默认入口文件
    null,
    [],
    function ($path) {
        // 自定义路径处理：不存在的路径回退到Symfony入口
        if (!Phar::isFile("phar://app.phar/{$path}")) {
            return 'index.php';
        }
        return $path;
    }
);

__HALT_COMPILER();

webPhar()会自动处理HTTP请求的头信息、静态文件缓存等，回调函数可以灵活调整请求路径的映射规则，完美适配Symfony的路由系统。

额外注意事项 #

• 打包Phar时，确保包含Symfony的所有依赖文件（vendor目录）、静态资源以及配置文件，避免Phar内部文件缺失导致的错误。
• 检查PHP配置：确保phar扩展已启用，生产环境可以设置phar.readonly = On，开发环境如果需要修改Phar则设为Off。
• 测试时先通过CLI运行php app.php验证Phar本身是否正常，再在浏览器中测试路由规则。

内容的提问来源于stack exchange，提问作者Michał G