Laravel 8资源路径适配问题：本地与服务器环境自动适配方案咨询

你遇到的是Laravel部署中很常见的资源路径不匹配问题——本地用Laravel自带服务器时，它会自动把public作为网站根目录，但生产服务器大概率是把根目录指向了项目的根文件夹，导致asset()生成的路径找不到public下的资源。下面给你几个不用手动修改Blade文件的解决方案：

方案一：修正服务器根目录配置（最推荐，符合Laravel最佳实践） #

Laravel的设计逻辑就是把public文件夹作为网站的根目录，这样能避免项目核心代码被直接访问。你需要调整服务器的配置：

• Apache：修改虚拟主机配置，把DocumentRoot指向项目的public文件夹，示例：

  DocumentRoot "/var/www/your-project/public"
  <Directory "/var/www/your-project/public">
      AllowOverride All
      Require all granted
  </Directory>
  

• Nginx：修改server块的root指令为项目的public路径，示例：

  server {
      listen 80;
      server_name yourdomain.com;
      root /var/www/your-project/public;
  
      location / {
          try_files $uri $uri/ /index.php?$query_string;
      }
  }
  

配置完成后，asset()生成的路径会直接对应public下的资源，本地和服务器环境无需任何代码修改。

方案二：通过.env文件配置ASSET_URL（灵活适配不同环境） #

如果没办法修改服务器根目录配置，可以利用Laravel的ASSET_URL环境变量自动添加路径前缀：

1. 在项目根目录的.env文件中添加（或修改）这个变量：
   • 本地开发环境：

     ASSET_URL=
     

   • 生产服务器环境：

     ASSET_URL=/public
     

2. 保存后，Laravel的asset()方法会自动使用这个前缀生成路径。比如服务器上asset('vendor/bootstrap/css/bootstrap.min.css')会生成/public/vendor/bootstrap/css/bootstrap.min.css，本地则保持原来的路径。

方案三：调整.htaccess规则（适配现有服务器配置） #

你已经有自定义的.htaccess规则，可以扩展它来覆盖vendor目录的重写：
修改现有规则中最后一条RewriteRule，把vendor加入匹配范围：

<IfModule mod_rewrite.c>
    <IfModule mod_negotiation.c>
        Options -MultiViews -Indexes
    </IfModule>

    RewriteEngine On

    # Handle Authorization Header
    RewriteCond %{HTTP:Authorization} .
    RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]

    # Redirect Trailing Slashes If Not A Folder...
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_URI} (.+)/$
    RewriteRule ^ %1 [L,R=301]

    # Send Requests To Front Controller...
    RewriteCond %{REQUEST_URI} !(\.css|\.js|\.png|\.jpg|\.gif|robots\.txt)$ [NC]
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^ index.php [L]

    # 新增vendor目录的重写规则
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_URI} !^/public/
    RewriteRule ^(css|js|images|vendor)/(.*)$ public/$1/$2 [L,NC]
</IfModule>

这样当访问/vendor/bootstrap/css/bootstrap.min.css时，服务器会自动重写到/public/vendor/bootstrap/css/bootstrap.min.css，无需修改Blade中的asset()代码。

内容的提问来源于stack exchange，提问作者DIGITAL JEDI