在 Windows 上部署 Laravel 项目

Laravel 框架中须要部署 PHP Web、队列、任务调度三部分功能，官方文档中只有 Linux 下的部署说明。虽然 Linux 纯 CLI 看起来更高大上，不过 Windows 也是一种解决方案。

PHP Web

参考 在 Windows 上使用 IIS 部署 PHP 项目 完成运行环境配置。

在 Laravel 项目 public 目录下已经存在一个用于 IIS 部署的 web.config 文件，内容是 Url Rewrite 规则：

<configuration>
  <system.webServer>
    <rewrite>
      <rules>
        <rule name="Imported Rule 1" stopProcessing="true">
          <match url="^(.*)/$" ignoreCase="false" />
          <conditions>
            <add input="{REQUEST_FILENAME}" matchType="IsDirectory" ignoreCase="false" negate="true" />
          </conditions>
          <action type="Redirect" redirectType="Permanent" url="/{R:1}" />
        </rule>
        <rule name="Imported 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>
复制代码

添加 IIS 站点时，站点物理路径须要指向到 public 目录下。通常状况下，站点其余相关配置会从根配置文件继承，好比 FastCGI 相关配置。同时运行多个站点须要为站点绑定域名，不然只能有一个站点使用 80 端口。

跨域控制

关于 Web 跨域能够阅读 MDN 的文档进一步了解——HTTP访问控制（CORS） 。t经过添加特定的响应头来控制 Web 浏览器的跨域限制，IIS 能够在 HTTP 响应标头 来设置相应的响应头。

HTTP 响应标头 能够在 IIS 管理器中做为全局设置，也能够针对站点设置。若是针对站点配置，那么会修改站点物理路径下的 web.config 文件。

设置完后，能够看到 web.config 中 rewrite 节点后面增长了 httpProtocol 节点。

<httpProtocol>
    <customHeaders>
        <add name="Access-Control-Allow-Origin" value="example.com" />
    </customHeaders>
</httpProtocol>
复制代码

其余配置项也是相似，推荐的作法是将变动后的 web.config 文件签入版本控制系统进行管理。

须要注意，这里配置是所有 URL 都会生效，若是须要针对特定 URL 路径须要手动添加如下内容到<configuration> 节点：

<location path="api">
    <system.webServer>
        <httpProtocol>
            <customHeaders>
                <add name="Access-Control-Allow-Origin" value="example.com" />
            </customHeaders>
        </httpProtocol>
    </system.webServer>
</location>
复制代码

若是须要更详细的 CORS 控制须要安装 IIS CORS Module，参考 IIS CORS module Configuration Reference | Microsoft Docs 进行配置。

固然，在 PHP 代码中控制会更加灵活。

客户端缓存

Web 客户端缓存主要经过 Cache-Control、ETag、Last-Modified 响应头控制，关于 HTTP 缓存能够查看 MDN 文档了解更多 developer.mozilla.org/zh-CN/docs/…。

这里的客户端缓存控制主要是针对静态资源，动态资源能够在代码中进行控制。符合 HTTP 协议的客户端，包括浏览器，还有 APP 开发中使用的 HTTP 请求库，默认状况下都会按照 HTTP 协议约定进行缓存。

默认状况下，IIS 对静态资源请求的响应头中就包含 Etag 与 Last-Modified。能够在 HTTP 响应标头 中经过 设置经常使用标头 选项进行配置 Cache-Control，响应头以下：

HTTP/1.1 200 OK
Cache-Control: max-age=86400
Content-Type: application/javascript
Content-Encoding: gzip
Last-Modified: Fri, 11 Jan 2019 15:06:10 GMT
Accept-Ranges: bytes
ETag: "05d6b2fbfa9d41:0"
Vary: Accept-Encoding
Date: Sat, 12 Jan 2019 17:26:08 GMT
Content-Length: 112411
复制代码

若是是在站点操做完成以后一样会在项目 public 目录下的 web.config 中添加相关节点：

<staticContent>
    <clientCache cacheControlMode="UseMaxAge" cacheControlMaxAge="1.00:00:00" />
</staticContent>
复制代码

若是须要按目录控制，手动添加如下内容到<configuration> 节点:

<location path="favicon.ico">
    <system.webServer>
      <staticContent>
        <clientCache cacheControlCustom="public" cacheControlMode="UseMaxAge" cacheControlMaxAge="365.00:00:00" />
      </staticContent>
    </system.webServer>
</location>
复制代码

更多关于 <staticContent> 参数能够查看官方文档 Client Cache | Microsoft Docs。

SQL Server

若是说有什么缘由必定要在 Windows 上部署 PHP Web 项目，那么 SQL Server 必定是个很常见的缘由。

PHP 访问 SQL Server 数据库须要安装两个数据库驱动程序：

• Microsoft Drivers for PHP for SQL Server
• Microsoft ODBC Driver for SQL Server

影响因素包括以上两个驱动的版本、SQL Server 版本、PHP 版本以及 Windows 版本。详细的对应关系能够经过官方文档 System Requirements for the Microsoft Drivers for PHP for SQL Server - SQL Server | Microsoft Docs 查看。

以 Laravel 5.7 版本的需求 PHP >= 7.1.3 为例：

• Microsoft Drivers for PHP for SQL Server 5.3/5.2
• Microsoft ODBC Driver for SQL Server 17+/13.1/11
• SQL Server 2008 R2 ~ SQL Server 2017
• Windows 10 、Windows Server 2012 ~ Windows Server 2016

总结：开发环境只能选择 Windows 10，生产环境最低要选择 Window Server 2012。

安装 Microsoft Drivers for PHP for SQL Server 5.3 与 Microsoft ODBC Driver for SQL Server 17+，配置好 PHP 的扩展以后，能够访问 SQL Server 2008 R2 ~ SQL Server 2017 版本的数据库。

队列

官方文档中部署队列的方式是使用 Supervisor, Linux 上也可使用 systemd 来部署。Windows 上采用一样的思路，将队列运行做为系统服务运行，须要用到 NSSM - the Non-Sucking Service Manager。

将下载好的 nssm.exe 路径添加到系统 Path 变量中以后，在命令行中使用 nssm install <servicename> 会打开 GUI 界面配置。

Path 推荐填写完整的 php.exe 路径，Startup directory 是启动目录，填写项目根目录，Arguments 运行参数 artisan queue:work sqs --sleep=3 --tries=3。

其余须要注意的是 Log on 服务以何用户运行，涉及到权限、环境变量、认证，通常状况保持 Local System account 便可。若是使用指定用户，用户密码失效或改变时，会形成服务没法启动。

任务调度

任务调度与队列的区别在于执行周期不一样，官方文档中任务调度的部署方式是使用 crontab 以分钟为周期调用单一任务入口，Windows 上经过计划任务能够实现相同的目的。

打开计划任务程序，建立任务。触发器选择 按预约计划、一次，可是时间要调整为已通过去的时间。重复任务间隔设置为 1 分钟，持续期限 设置为 无期限。

操做中配置程序填写 PHP.exe 的完整路径。起始于 配置为 Laravel 项目路径，参数填写 artisan schedule:run。

在设置中勾选 若是过了计划开始时间，当即启动任务，去掉 若是请求后任务还在运行，强行将其中止，最后选择 请勿启动新实例。