f2h2h1.github.io

在Windows下配置PHP服务器

环境依赖

Windows 10 (x64) 20H2
php 7.4
MySQL 8 或 5.7
apache 2.4
nginx 1.12
redis 3.2.1 (redis 的 windows 版已经很久没更新了，虽然还是能用)
git for windows 2.33 (虽然 git 和运行 php 没有关系，但用 composer 安装依赖时有些时候会直接从 github 里拉取代码，如果这时系统里没有安装 git 可能会报错)

php

下载 php

http://php.net/downloads.php

这里要注意，如果用 apahce_mod 运行 php ，那么 php 需要是 ts 版，因为 ts 版才有这个模块 php7apache2_4.dll

php 需要安装 vc 依赖，在 php 下载页面的左边有 vc 库的下载链接的，用心找一下

不同版本的 php 对应的 vc 版本是不一样的，如果不清楚这个对应关系，就把全部的 vc 版本都安装一次（只要能安装上）

配置 php

解压下载下来的压缩包
把解压后的文件夹重命名为 php
把 php 文件夹复制到 C 盘的根目录下（这里可以是任意目录）
把 php 文件夹的路径添加到环境变量
进入 php 文件夹，把 php.ini-development 复制一份，并把复制那份文件重命名为 php.ini

打开 php.ini

修改拓展目录 extension_dir = "ext"

开启以下拓展，这些只是比较常用的拓展，拓展的开关要根据实际需求来确定

  extension=curl
  extension=fileinfo
  extension=gd2
  extension=gettext
  extension=gmp
  extension=intl
  extension=mbstring
  extension=exif
  extension=mysqli
  extension=openssl
  extension=pdo_mysql
  extension=pdo_sqlite
  extension=sockets
  extension=sqlite3
  extension=xsl

除了拓展之外，还有一些比较常用的配置修改

  file_uploads 是否允许上传文件
  upload_max_filesize 上传文件的最大值
  max_file_uploads 上传文件数量的最大值
  post_max_size post 请求的最大值
  short_open_tag 是否开启短标签
  memory_limit 运行内存的最大值
  max_execution_time 运行时间的最大值
  short_open_tag 是否启用短标签

最好也启用 opcache ，启用 opcache 需要在配置文件的 [opcache] 下加上这样一句 zend_extension = "php path\ext\php_opcache.dll"
还有就是命令行运行也启用 opcache opcache.enable_cli=1

composer

下载安装脚本

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

安装
```
php composer-setup.php
```
删除安装脚本
```
php -r "unlink('composer-setup.php');"
```

使用中国镜像

composer config -g repo.packagist composer https://packagist.phpcomposer.com

在 PHP 的文件夹下新建一个名为 composer.bat 的文件，把以下内容复制进去，然后保存
```
@php "%~dp0composer.phar" %*
```
在 PHP 的文件夹下新建一个名为 composer 的文件，把以下内容复制进去，然后保存，这样在 git bash 里也可以直接用 composer 的命令了
```
#!/usr/bin/env sh
php "$(dirname "$0")"/composer.phar $*
```

xdebug

xdebug 的配置可以参考这篇文章《在 VSCode 里调试 PHP》

MySQL

下载 MySQL

目标，下载 MySQL 8 的社区版的 ZIP 版本
打开 MySQL 的官网
```
https://dev.mysql.com/
```
点击上方的 DOWNLOAD
拉到页面的最下面，点击 Community (GPL) Downloads ，这个是社区版，只有社区版是免费的
点击 MySQL Community Server
拉到页面下面，找到 Other Downloads 选择里面的 ZIP 版本，点击 Download
点击 No thanks, just start my download

配置 MySQL

在 C 盘的根目录下新建一个名为 mysql 的文件夹，解压下载后的文件，把文件解压到 C:/mysql （这里可以是任意目录）
把 C:/mysql/bin 添加进环境变量 Path
在 mysql 文件夹里新建一个名为 data 的文件夹

在 mysql 文件夹里新建一个名为 my.ini 的文件

 [mysqld]
 # 设置3306端口
 port=3306
 # 设置mysql的安装目录
 basedir=C:\\mysql
 # 设置mysql数据库的数据的存放目录
 #datadir=C:\\mysql\\data
 # 允许最大连接数
 max_connections=200
 # 允许连接失败的次数。这是为了防止有人从该主机试图攻击数据库系统
 max_connect_errors=10
 # 服务端使用的字符集默认为UTF8
 character-set-server=utf8
 # 创建新表时将使用的默认存储引擎
 default-storage-engine=INNODB
 [mysql]
 # 设置mysql客户端默认字符集
 default-character-set=utf8
 [client]
 # 设置mysql客户端连接服务端时默认使用的端口
 port=3306
 default-character-set=utf8

my.ini 的编码必须为 utf-8 无 bom，换行符使用 \n
遇到错误时，可以去查看 data 文件夹里， err 后缀的文件

初始化
- 初始化命令
```
  mysqld --initialize
```
- 注意，执行完之后，会自动生成一个密码，这个密码需要记下来，这个是命令行登录的密码。如果命令行里没有输出密码，那么就去 data 文件夹里，找到 err 后缀的文件，密码再这里面
- 初始化后，第一次运行 mysqld ，要用命令行登录，然后修改密码。初始化的密码如果不修改好像不能通过 php 或其它客户端连接
- 第一次运行时的密码修改
```
  # 以这样的方式运行 mysqld
  mysqld --skip-grant-tables --shared-memory --console
  # 使用 mysql 登录并修改密码
  mysql -uroot -p
  use mysql;
  flush privileges;
  ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '新密码';
  flush privileges;
  quit
```
运行
- 直接在命令行运行
```
  mysqld --console
```
- 以服务的形式运行在管理员模式的命令行下 cd 进 C:/mysql/bin 目录，以次运行以下命令，虽然已经添加进环境变量，但然要在目录下运行。
  - 注册服务 mysqld install mysql
  - 启动服务 net start mysql
  - 停止服务 net stop mysql
  - 移除服务 mysqld remove mysql
  - 上面命令的服务名是 mysql ，这个服务名可以自定以的。启动服务前需要先注册服务，移除服务前需要先停止服务。
- 只能以一种方式运行，因为是 zip 版，笔者更倾向于用命令行运行

修改密码，以次运行以下命令

 # 登入 mysql
 mysql -uroot -p
 # 使用 mysql 库
 use mysql;
 # 修改密码
 ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的密码';
 # 刷新权限
 flush privileges;

MySQL 的 ZIP 版本容易出现各种奇怪的错误，安装版能省心一点

5.7

下载 zip 版
从官网下载时，要用心找一下，因为 5.7 算是旧版了，下载地址不像 8 那样显眼
5.7 的配置和 8 基本一致

如果没有加入到环境变量，需要显式声明配置文件的地址，像这样

 初始化 mysql
 mysqld --defaults-file="C:\Program Files\mysql-5.7.34-winx64\my.ini" --initialize

5.7 第一次运行时使用这样的命令， –skip-grant-tables 是忽略权限验证的意思

 mysqld --defaults-file="C:\Program Files\mysql-5.7.34-winx64\my.ini" --console --skip-grant-tables

第一次运行时要修改 root 密码
用命令行运行mysql的客户端
```
 mysql -uroot
```

进入 mysql 后，依次运行下面的命令

 use mysql;
 update user set authentication_string=password('1234') where user='root';
 flush privileges;

之后就可以退出mysql客户端和mysqld了，关掉 mysqld ，以后运行 mysqld 就用这样的命令
```
 mysqld --defaults-file="C:\Program Files\mysql-5.7.34-winx64\my.ini" --console
```
因为没有加入到环境变量，所以需要显式声明配置文件的路径，运行目录也需要是安装路径/bin
从安装配置的角度来看， 5.7 和 8 最大的不同是，修改密码的方式
- 5.7 和 8 修改密码的 sql 语句也有一点差别

Apache

下载 Apache

https://www.apachelounge.com/download/

Apache 官方只提供源码，二进制文件都是第三方编译的，这里选择 Apache Lounge 提供的二进制文件

配置 Apache

把 Apache 添加进环境变量
把 php 目录下的 php7apache2_4.dll 复制到 Apache 目录下的 modules
打开 Apache 的配置文件 httpd.conf，往 httpd.conf 里添加 php 的模块，httpd.conf 这个文件在 Apache 安装目录的 conf 文件夹里
```
 LoadModule php7_module modules/php7apache2_4.dll

 AddHandler application/x-httpd-php .php
 PHPIniDir "C:/php"
```
- 这段配置，加在 httpd.conf 的 179 行左右，就是加载模块那部分的尾部
- 如果遇到这种错误
```
  httpd.exe: Syntax error on line 187 of Apache24/conf/httpd.conf: Cannot load modules/php8apache2_4.dll into server:
```
- 可以尝试这样解决
  - 检查 httpd.conf 里的 SRVROOT 不否有填好
  - 检查 Apache 与 PHP 版本的位数是否一致
    - 必须是都是 32 位或都是 64 位
  - 试试模块名由 php8_module 改成没有版本号的 php_module
  - 试试模块的路径填绝对路径
    - 例如这样 C:/php/php8apache2_4.dll
    - 但这样的路径却不行 C:/apache/modules/php8apache2_4.dll ，虽然不知道为什么
打开 httpd.conf，将里面的 #ServerName localhost:80 注释去掉。
在 httpd.conf 里找到这一段

<Directory />
    AllowOverride none
    Require all denied
</Directory>

把这一段修改为

<Directory />
    AllowOverride none
    Require all granted
</Directory>

把 httpd.conf 里的 #Include conf/extra/httpd-vhosts.conf 注释去掉。
打开 httpd-vhosts.conf，把里面的例子删掉
在 httpd-vhosts.conf 里添加一个站点 ```plaintext

<VirtualHost *:80> ServerAdmin webmaster@dummy-host3.example.com # 站点根目录 DocumentRoot “C:\www\wwwroot\dummy-host2.example.com.cn” # 站点域名 ServerName dummy-host2.example.com.cn # 错误日志 ErrorLog “C:\www\wwwlog\dummy-host2.example.com-error.log” # 日志 CustomLog “C:\www\wwwlog\dummy-host2.example.com-access.log” common # 默认文件名 DirectoryIndex index.html index.php </VirtualHost>

注意，这里的站点目录和日志目录需要在自己新建

测试配置文件

httpd -t


查看帮助

httpd -h

9. 启动 Apache，在命令行里运行
```plaintext
httpd

以服务的形式运行 Apache，先注册服务，然后再启动服务。停止 Apache 的时候就停止服务，卸载 Apache 的时候需要先移除服务。
- 注册服务
```
httpd -k install
```
- 移除服务
```
httpd -k uninstall
```
- 启动服务
```
httpd -k start
```
- 停止服务
```
httpd -k stop
```
- 重启服务
```
httpd -k restart
```

注意，在调用 httpd 注册 Apache 的服务时，弹出这句话

Errors reported here must be corrected before the service can be started

并不是 error ，而是提示：如果这行下边出现错误则解决错误后再启动！

https 配置

安装 ssl 模块 mod_ssl.so ，大多数情况下 mod_ssl.so 是默认安装好的
启用 mod_ssl.so ，就是在 httpd.conf 文件里把那句 mod_ssl.so 的注释删掉
监听 443 端口 listen 443

在 VirtualHost 里至少加上这几个字段

 SSLEngine on
 SSLCertificateFile "${SRVROOT}/conf/ssl/domain.crt"
 SSLCertificateKeyFile "${SRVROOT}/conf/ssl/rsa_private_key.pem"

大概的例子

 <VirtualHost _default_:443>
 DocumentRoot "${SRVROOT}/htdocs"
 ServerName 2.example.com:443
 ServerAlias 3.example.com 4.example.com
 SSLEngine on
 SSLCertificateFile "${SRVROOT}/conf/ssl/domain.crt"
 SSLCertificateKeyFile "${SRVROOT}/conf/ssl/rsa_private_key.pem"
 </VirtualHost>

http2 配置

安装 ssl 模块 mod_http2.so ，大多数情况下 mod_http2.so 是默认安装好的
启用 mod_http2.so ，就是在 httpd.conf 文件里把那句 mod_http2.so 的注释删掉
在 VirtualHost 里至少加上这个字段
```
 Protocols h2 h2c http/1.1 http/1.0
```

大概的例子

 <VirtualHost _default_:443>
 DocumentRoot "${SRVROOT}/htdocs"
 ServerName 2.example.com:443
 ServerAlias 3.example.com 4.example.com
 SSLEngine on
 SSLCertificateFile "${SRVROOT}/conf/ssl/domain.crt"
 SSLCertificateKeyFile "${SRVROOT}/conf/ssl/rsa_private_key.pem"
 Protocols h2 h2c http/1.1 http/1.0
 </VirtualHost>

启用 http2 必须先启用 https

nginx

下载 nginx

http://nginx.org/download/nginx-1.21.1.zip

配置 nginx

解压下载的压缩包

修改 config/nginx.conf 这个文件

worker_processes 设为 cpu 逻辑核心数的两倍，例如 cpu 是 2 核 4 线程，那么 worker_processes 就是 8 ，但 worker_processes 的值最好不要超过 8

加上站点的配置， nginx.conf 里原本就有一个站点的配置例子，可以在那个例子上修改，或者把那个例子整个注释掉，然后加上这段配置

  server {
      listen       80;
      server_name  localhost;

      access_log  logs/localhost.access.log;
      error_log  logs/localhost.error.log;

      location / {
          root   C:/wwwroot; # 这是站点根目录的路径
          index  index.html index.htm;
      }

      location ~ \.php$ {
          root           C:/wwwroot; # 这是站点根目录的路径
          fastcgi_pass   127.0.0.1:9001;
          fastcgi_index  index.php;
          include        fastcgi.conf;
      }
  }

https 的配置
- 在 server 块里加上这三句
- ssl_certificate 是证书路径， ssl_certificate_key 是私钥路径
- ssl_certificate 和 ssl_certificate_key 的路径，要么填绝对路径，要么填相对于 nginx 根目录的路径
- http2 不是必须的，但现在的浏览器都支持了，多加一句能稍微提升一下性能
```
 listen       443 ssl http2;
 ssl_certificate  ./crt/127.0.0.1/domain.crt;
 ssl_certificate_key ./crt/127.0.0.1/rsa_private_key.pem;
```

启动 nginx

启动 php-cgi ，端口号要和 nginx 的配置里一致， PHP_FCGI_CHILDREN 如果不设置，默认值是 1 ，性能会比较差，大部分情况下和 nginx 的 worker_processes 设为一样就可以了
```
 set PHP_FCGI_CHILDREN=8
 php-cgi -b 127.0.0.1:9001
```
启动 nginx ，直接在 nginx 的根目录下运行 nginx 就可以了
一些常用的命令，这些命令也是需要在 nginx 的根目录下运行
- 退出 nginx nginx -s quit
- 停止 nginx nginx -s stop
- 重载配置 nginx -s reload
- 测试配置文件 nginx -T
- 查看帮助 nginx -h
退出 nginx 最好使用信号的方式退出，直接关掉 nginx 的进程，可能会有 nginx 子进程残留

redis

下载 redis

https://github.com/MicrosoftArchive/redis/releases

这里推荐下载 zip 版

redis 的 windows 版已经很久没更新了。 redis 的官方好像是推荐用 wsl2 在 windows 里安装 redis

https://redis.com/blog/redis-on-windows-10/
https://redis.io/docs/getting-started/installation/install-redis-on-windows/

据说 redis 无法支持 windows 的原因是 windows 没有 fork 系统调用（和 fpm 不支持 windows 的原因是一样的）。好像是没有 fork 功能，redis 就无法执行某些必要的数据库保存方法。

运行 redis

下载完后解压，然后 cd 进目录，然后运行这段

redis-server.exe redis.windows.conf

php 的 redis 扩展

下载 https://pecl.php.net/package/redis

下载完后，把 dll 文件放在 php 的 ext 目录。

然后修改 php.ini ，加上下面这一行，最好加在那些拓展的位置

extension=php_redis.dll

参考

https://www.redis.com.cn/redis-installation.html

其它

nginx 和 apache 大多数情况下安装一个就可以，当然啦 nginx 反代 apache 也是可以的。

相比于 xampp 和 wampp 这类集成环境，笔者更喜欢，全部软件都自行安装。因为这样可以更好地控制各个软件的配置，和方便地安装同一个软件的多个版本 ~~（所以这篇文章里的 mysql 才会选 zip 版来安装）~~ 。

笔者对 Windows 的服务并不了解，所以大多数软件都是通过命令行直接运行的。

可以用 NSSM 把像 php-cgi 这类在命令行运行的程序封装成服务。或者用 instsrv 和 srvany 配合，也可以把任意 exe 封装成服务。 instsrv.exe 和 srvany.exe 是 Microsoft Windows Resource Kits 工具集中的两个实用工具。

https 自签证书的生成，可以参考这篇文章《密码学入门简明指南》的这个章节 OpenSSL 的一般使用。

phpmyadmin

下载 phpmyadmin
```
 https://www.phpmyadmin.net/
```
下载完后解压
打开这两个文件 /libraries/config.default.php /config.sample.inc.php ，设置这两个文件里的这个值，这个值的长度要大于 64
```
 $cfg['blowfish_secret'] = ''
```
可以在这个文件里 /config.sample.inc.php 修改 mysql 的连接参数
配置好站点就可以直接运行了，当然也可以在根目录里用 php 的内置服务器运行
除了 phpmyadmin 外，这里还推荐使用 dbeaver 或 heidisql 作为数据库的管理工具

phpredisadmin

下载 phpredisadmin

 https://github.com/ErikDubbelboer/phpRedisAdmin

解压后，配置好站点就可以直接运行了，当然也可以在根目录里用 php 的内置服务器运行
现在的 redis 也提供 gui 工具了 https://redis.com/redis-enterprise/redis-insight/

hosts

hosts 是用来修改本地的域名解释

hosts 的文件位置是 %WINDIR%\System32\drivers\etc\hosts

其中 %WINDIR% 是系统所在目录，一般是 %HOMEDRIVE%\WINDOWS

其中 %HOMEDRIVE% 是系统所在分区，一般是 C:

所以一般情况下 hosts 的文件位置是 C:\WINDOWS\System32\drivers\etc\hosts

修改 hosts 需要管理员权限，直接用记事本修改会保存失败的，可以用 vscode 修改

或者打开管理员的命令行，再在命令行里打开记事本，再用记事本打开 hosts 例如这样这是 bat 的

notepad %WINDIR%\System32\drivers\etc\hosts

或者这样这是 powershell 的

notepad $env:windir\system32\drivers\etc\hosts

hosts 修改后，可以用这个命令 nslookup 域名 来判断有没有生效

hosts 修改后如果沒有生效，可以用这个命令刷新 DNS ipconfig /flushdns

一些实用的命令

netstat

  查看端口占用，第二列是本地监听的地址和端口，第二列是远程监听的地址和端口，最后一列是 pid
  netstat -ano
  列出进程名
  netstat -anob
  只查看 TCP
  netstat -anob -p TCP
  查看 TCP 下的 80 端口占用
  netstat -anob -p TCP | findstr "80"

tasklist

  tasklist /V /FI "WINDOWTITLE eq titlename"
  tasklist /V /FI "PID eq 9088"
  tasklist /V /FI "IMAGENAME eq nginx.exe"
  tasklist /V /FI "IMAGENAME eq nginx.exe" /FI "WINDOWTITLE eq titlename"

taskkill

  taskkill /T /F /FI "WINDOWTITLE eq titlename"
  taskkill /T /F /FI "PID eq 9088"
  taskkill /T /F /FI "IMAGENAME eq nginx.exe"

This site is open source. Improve this page.