Laravel 6 修改public_path() 实现public文件夹目录迁移配置
Laravel 6 自定义
public_path()实现public目录迁移的正确方法 场景背景
当前项目为Laravel 6版本,部署在子域名对应的站点目录下,需要将框架默认的public文件夹迁移到其他指定目录。目前尝试多套配置方案均未达到预期效果,不清楚自定义public_path()的正确配置位置。
之前尝试方案无效的原因
- 容器绑定逻辑差异:Laravel 6 在初始化应用实例时,会直接将默认的public路径(项目根目录下的public文件夹)以实例绑定的方式写入容器,在AppServiceProvider中使用
bind方式注册的回调,仅在容器不存在对应绑定键时才会触发,无法覆盖已经存在的实例值,因此不会生效。 - 写入位置不对:如果在入口文件
index.php里写$app->bind('path.public', ...),此时应用已经完成核心初始化流程,绑定逻辑无法再覆盖已经固化的路径值。 - 混淆配置边界:修改
config/filesystems.php里的public磁盘参数,仅影响Storage门面的文件读写路径,和全局public_path()辅助函数的返回值没有关联,自然无法达到预期效果。
正确的实现步骤
1. 核心路径配置
Laravel 6 内置了专门用于设置public路径的usePublicPath()方法,直接在bootstrap/app.php中、应用实例初始化完成后调用即可,优先级最高,不会被后续流程覆盖。
操作方式:打开项目根目录下的bootstrap/app.php,找到应用实例创建的代码块,在其后追加路径设置代码:
// 原有创建应用实例的代码 $app = new Illuminate\Foundation\Application( $_ENV['APP_BASE_PATH'] ?? dirname(__DIR__) ); // 追加自定义public路径配置,根据实际目录结构调整路径值 // 示例路径:项目根目录在对外可访问目录的同级上层位置 $app->usePublicPath(realpath(__DIR__.'/../../public_html'));
路径值可以根据实际目录结构调整,只要保证最终
public_path()指向web服务器对外可访问的目录即可。
2. 迁移原有public目录内容
将原Laravel项目public文件夹下的所有内容(入口文件index.php、.htaccess静态资源路由规则、robots.txt、前端编译生成的css/js、mix-manifest.json等)全部移动到刚才设置的自定义public目录下。
3. 修正入口文件引用路径
因为入口文件index.php已经从原public目录移动到了新的自定义目录,需要修正文件内的框架加载路径,保证框架核心文件能被正确加载:
打开移动后的index.php,修改对应的require路径为实际的Laravel项目核心文件位置,示例:
// 原来的相对路径(public目录下的默认配置) // require __DIR__.'/../vendor/autoload.php'; // $app = require_once __DIR__.'/../bootstrap/app.php'; // 修正后的实际路径(示例中项目根目录和对外可访问目录同级) require __DIR__.'/../laravel项目目录名/vendor/autoload.php'; $app = require_once __DIR__.'/../laravel项目目录名/bootstrap/app.php';
配置验证方式
在项目根目录执行php artisan tinker进入交互终端,输入public_path(),返回值如果和设置的自定义目录完全一致,就说明配置生效。
内容的提问来源于stack exchange,提问作者shahab ershad
相关产品推荐
相关产品推荐

