Laravel包开发：如何通过URL访问公共路径

一、asset()失效的核心原因 #

asset()助手默认基于主项目的public目录生成URL，但包的静态资源一般存放在包内部的resources/assets或专属public目录里，主项目的asset无法识别这些路径，自然会出现异常。

二、asset()的正确使用方式 #

1. 发布包资源到主项目public（标准方案） #

在包的服务提供者boot()方法中注册资源发布规则：

public function boot()
{
    // 将包内public目录内容发布到主项目public/vendor/你的包名目录下
    $this->publishes([
        __DIR__.'/../public' => public_path('vendor/your-package-name'),
    ], 'public');
}

终端执行Artisan命令完成发布：

php artisan vendor:publish --tag=public --force

之后即可用asset()指向发布后的路径：

asset('vendor/your-package-name/css/style.css')

2. 自定义Helper函数（开发阶段快捷方案） #

不想频繁发布资源的话，在包内创建自定义helper生成资源URL：

// 包根目录新建helpers.php
function package_asset($path)
{
    return url(rtrim(config('app.url'), '/') . '/vendor/your-package-name/' . ltrim($path, '/'));
}

在服务提供者boot()方法中加载该helper：

public function boot()
{
    require __DIR__.'/../helpers.php';
}

使用时直接调用：

package_asset('js/app.js')

三、获取public文件夹的URL路径 #

1. 获取主项目public根URL #

用url()助手最直接：

// 输出主项目public根URL，例如http://your-domain.com
url('/')
// 若public目录不是web根目录，补充对应路径
url('/public')

也可以用asset('')，效果和url('/')一致。

2. 服务器路径转URL #

如果只有public_path()返回的服务器绝对路径，转URL可这么写：

$file_path = public_path('css/app.css');
$file_url = asset(str_replace(public_path(), '', $file_path));

3. 获取包自身public目录URL（未发布时） #

先在主项目服务器配置里，把包的public目录映射到/vendor/你的包名路径，再用：

url('/vendor/your-package-name')

内容的提问来源于stack exchange，提问作者Bhargav Raviya