IIS部署Laravel应用教程详解

本文详细阐述了在IIS服务器上部署Laravel PHP应用的完整过程。内容涵盖了IIS与PHP环境的集成配置，特别是PHP扩展在IIS管理器中的正确映射，以及Laravel项目准备和IIS网站的创建与URL重写规则的配置。教程强调了web.config文件的作用和常见部署问题的排查，旨在帮助开发者顺利在Windows服务器环境下运行Laravel应用。

1. 部署环境准备

在IIS上部署Laravel应用前，需确保服务器环境已满足以下基本要求：

• IIS (Internet Information Services): 确保IIS已安装并运行。可以通过“服务器管理器”的“添加角色和功能”来安装Web服务器（IIS）角色。
• PHP: 下载并安装适合您IIS版本的PHP解释器。推荐使用非线程安全（NTS）版本，因为它更适合FastCGI模式。
• Composer: Laravel的依赖管理工具，用于安装项目依赖。
• IIS URL Rewrite Module: 这是IIS的一个扩展，用于实现URL重写功能，对Laravel的优雅URL至关重要。可以从IIS官网下载并安装。

2. 配置IIS与PHP集成

正确配置IIS以识别和执行PHP脚本是部署Laravel的关键一步。

2.1 安装PHP并配置FastCGI

1. 将下载的PHP压缩包解压到服务器上的一个目录，例如 C:\php。
2. 在IIS管理器中，选择服务器节点，双击“处理程序映射”。
3. 在右侧“操作”面板中，点击“添加模块映射”。
   • 请求路径：*.php
   • 模块：FastCgiModule
   • 可执行文件：指向PHP安装目录下的php-cgi.exe文件，例如 C:\php\php-cgi.exe。
   • 名称：PHP_FastCGI (或其他您喜欢的名称)
   • 点击“请求限制”：在“映射”选项卡中，确保选中“仅当请求映射到文件或文件夹时”。
   • 点击“确定”保存。

重要提示： 许多部署失败的原因是忘记在IIS管理器中添加或正确配置PHP的可执行文件映射。确保php-cgi.exe路径正确且FastCgiModule已启用。

2.2 配置PHP的php.ini

进入PHP安装目录，复制php.ini-production为php.ini，并根据需要进行以下修改：

• 设置extension_dir指向PHP扩展目录，例如 extension_dir = "ext"。
• 启用必要的扩展，例如：

  extension=curl
  extension=fileinfo
  extension=gd
  extension=mbstring
  extension=mysqli
  extension=openssl
  extension=pdo_mysql
  extension=pdo_sqlite

• 根据应用需求调整memory_limit、upload_max_filesize等参数。

3. 准备Laravel项目

在部署前，确保您的Laravel项目已准备就绪：

1. 将Laravel项目文件上传到服务器上，例如 C:\inetpub\wwwroot\your_laravel_app。
2. 打开命令行，进入项目根目录，运行Composer安装依赖：

   composer install --no-dev

3. 复制.env.example为.env，并配置数据库连接、APP_KEY等环境变量：

   cp .env.example .env
   php artisan key:generate

4. 确保storage和bootstrap/cache目录具有IIS用户（通常是IIS_IUSRS或IUSR）的写入权限。

4. 配置IIS网站

4.1 创建新的网站

1. 在IIS管理器中，右键点击“网站”，选择“添加网站”。
2. 填写以下信息：
   • 网站名称: 您的网站名称，例如 LaravelApp。
   • 物理路径: 指向Laravel项目的public目录，例如 C:\inetpub\wwwroot\your_laravel_app\public。
   • 绑定:
     • 类型：http
     • IP地址：所有未分配或指定服务器IP。
     • 端口：80 (或您希望的端口)
     • 主机名：您的域名（如果使用域名访问），例如 your-domain.com。
3. 点击“确定”创建网站。

4.2 配置URL重写（web.config）

Laravel的优雅URL依赖于URL重写。在IIS中，这通过web.config文件实现。在Laravel项目的public目录下创建或编辑web.config文件，内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <rewrite>
            <rules>
                <!-- 规则1：重定向尾部斜杠，确保URL的规范性 -->
                <rule name="Rule 1" stopProcessing="true">
                    <match url="^(.*)/$" ignoreCase="false" />
                    <action type="Redirect" redirectType="Permanent" url="/{R:1}" />
                </rule>
                <!-- 规则2：将所有请求重写到public/index.php，排除现有文件和目录 -->
                <rule name="Rule 2" stopProcessing="true">
                    <match url="^" ignoreCase="false" />
                    <conditions>
                        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" ignoreCase="false" negate="true" />
                        <add input="{REQUEST_FILENAME}" matchType="IsFile" ignoreCase="false" negate="true" />
                    </conditions>
                    <action type="Rewrite" url="index.php" />
                </rule>
            </rules>
        </rewrite>
    </system.webServer>
</configuration>

说明：

• Rule 1: 处理URL末尾的斜杠，将其重定向为不带斜杠的形式，有助于SEO和规范化URL。
• Rule 2: 这是Laravel在IIS上运行的核心。它检查请求的URL是否不是一个真实存在的目录或文件，如果是，则将其内部重写到public/index.php。这意味着所有Laravel路由请求都会被index.php处理。

确保IIS服务器上已安装并启用了“URL 重写”模块。

5. 故障排除与注意事项

• HTTP 500 错误或空白页：
  • 最常见原因： IIS未正确识别PHP。检查IIS管理器中的“处理程序映射”，确保*.php已正确映射到php-cgi.exe。这是原问题中解决方案的核心。
  • 检查PHP的php.ini文件，确保所有必要的扩展都已启用，并且extension_dir路径正确。
  • 检查Laravel的storage和bootstrap/cache目录权限，确保IIS用户拥有写入权限。
  • 查看IIS日志和PHP错误日志，获取更详细的错误信息。
• URL重写不生效： 确保IIS URL Rewrite模块已安装。
• 文件权限： 确保IIS用户对整个Laravel项目目录（至少是public、storage、bootstrap/cache）具有读取和执行权限，对storage和bootstrap/cache具有写入权限。
• PHP版本兼容性： 确保您使用的PHP版本与您的Laravel版本兼容。
• PHP-CGI进程池： 在IIS管理器中，可以调整FastCGI设置以优化PHP进程的性能和稳定性。

通过遵循上述步骤和注意事项，您应该能够在IIS服务器上成功部署和运行Laravel应用。