【Azure 應用服務】App Service For Linux 部署PHP Laravel 項目，如何修改首頁路徑為 wwwroot\public\index.php

問題描述

參考官方文檔部署 PHP Laravel 項目到App Service for Linux環境中，但是訪問應用時候遇見了500 Server Error 錯誤。

從部署的日志中，可以明確看出部署是成功的，那么為什么啟動頁面不成功呢？

 

問題分析

Laravel 應用程序生命周期在 public 目錄中開始，而不是在應用程序的根目錄(wwwroot)中開始。在Azure App Service中，所有項目的默認根目錄都是wwwroot。

但是可以使用 .htaccess 來重寫所有請求，使之指向 /public 而不是根目錄。 在存儲庫根目錄中，已針對此目的添加了 .htaccess。 有了它即可部署 Laravel 應用程序。

.htaccess文件(或者"分布式配置文件"）,全稱是Hypertext Access(超文本入口)。提供了針對目錄改變配置的方法， 即，在一個特定的文檔目錄中放置一個包含一個或多個指令的文件， 以作用於此目錄及其所有子目錄。

 

.htaccess 詳解：https://www.cnblogs.com/adforce/archive/2012/11/23/2784664.html

.htaccess 使用介紹：https://www.cnblogs.com/gyrgyr/p/10773118.html

問題解決

更改站點根路徑，所選的 Web 框架可能使用子目錄作為站點根路徑。 例如，Laravel 使用 public/ 子目錄作為站點根路徑。

應用服務的默認 PHP 映像使用 Apache，不允許為應用自定義站點根路徑。 若要避開此限制，請將 .htaccess 文件添加到存儲庫根路徑，並包含以下內容：

<IfModule mod_rewrite.c>
    RewriteEngine on
    RewriteCond %{REQUEST_URI} ^(.*)
    RewriteRule ^(.*)$ /public/$1 [NC,L,QSA]
</IfModule>

以上為修改Laravel項目的根目錄到 wwwroot/public中。如要指定到具體的啟動頁面，可以在public中加入頁面名稱，如 index.php。

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_URI} ^(.*)
RewriteRule ^(.*)$ public/index.php?/$1 [L]
</IfModule>

 

參考資料

App Service PHP laravel 更改站點根路徑： https://docs.azure.cn/zh-cn/app-service/configure-language-php?pivots=platform-linux#change-site-root

 

在 Azure 應用服務中生成 PHP 和 MySQL 應用： https://docs.azure.cn/zh-cn/app-service/tutorial-php-mysql-app?pivots=platform-linux

 

Laravel Lifecycle Overview： https://laravel.com/docs/5.4/lifecycle

First Things

The entry point for all requests to a Laravel application is the public/index.php file. All requests are directed to this file by your web server (Apache / Nginx) configuration. The index.php file doesn't contain much code. Rather, it is simply a starting point for loading the rest of the framework.

 

Apache's mod_rewrite： http://www.datakoncepts.com/seo or https://httpd.apache.org/docs/current/mod/mod_rewrite.html

The mod_rewrite module uses a rule-based rewriting engine, based on a PCRE regular-expression parser, to rewrite requested URLs on the fly. By default, mod_rewrite maps a URL to a filesystem path. However, it can also be used to redirect one URL to another URL, or to invoke an internal proxy fetch.

mod_rewrite provides a flexible and powerful way to manipulate URLs using an unlimited number of rules. Each rule can have an unlimited number of attached rule conditions, to allow you to rewrite URL based on server variables, environment variables, HTTP headers, or time stamps.

mod_rewrite operates on the full URL path, including the path-info section. A rewrite rule can be invoked in httpd.conf or in .htaccess. The path generated by a rewrite rule can include a query string, or can lead to internal sub-processing, external request redirection, or internal proxy throughput.