khs1994/wsl

WSL PHP开发环境镜像

镜像概述

本镜像旨在为Windows用户提供基于WSL（Windows Subsystem for Linux）的PHP开发环境解决方案，支持Ubuntu 16.04和Debian 9两种Linux发行版（推荐使用Debian 9）。通过该镜像，开发者可快速搭建包含Nginx、PHP（多版本）、MySQL等组件的本地开发环境，支持编译安装或脚本安装两种方式，满足不同开发需求。

核心功能与特性

• 多发行版支持：兼容Ubuntu 16.04和Debian 9，推荐使用Debian 9
• 灵活安装方式：支持源码编译安装或通过脚本快速安装（从Docker复制预编译软件或通过APT源安装）
• PHP多版本共存：支持PHP 5.6、7.0、7.1、7.2等版本，主版本可直接调用，其他版本需使用绝对路径
• 完整组件集成：包含Nginx、MySQL、PHP及常用扩展，满足PHP开发需求
• 便捷配置管理：提供配置文件示例（*.example），使用时移除后缀即可，便于自定义配置
• 环境变量隔离：通过APP_ENV=wsl标识WSL环境，避免与其他环境冲突

使用场景

• Windows平台下的PHP本地开发环境搭建
• 需要多PHP版本切换的开发场景
• 希望在Linux环境开发但依赖Windows系统的开发者
• 需要快速部署LNMP（Linux+Nginx+MySQL+PHP）开发环境的项目

使用方法

环境准备

1. 在Windows应用商店搜索并安装Debian 9（推荐）或Ubuntu 16.04
2. 确保WSL已启用并正常运行

设置环境变量

Windows端环境变量配置（PowerShell）

bash
# 设置LNMP_PATH环境变量
[environment]::SetEnvironmentvariable("LNMP_PATH", "$env:HOME/lnmp", "User")

# 将相关路径添加到系统Path
[environment]::SetEnvironmentvariable("Path", "$env:Path;$env:LNMP_PATH\windows;$env:LNMP_PATH\wsl", "User")

WSL端环境变量配置

bash
# 编辑系统环境变量文件
sudo vi /etc/profile

# 在文件末尾添加以下内容（注意替换WSL_HOME为实际路径）
export WSL_HOME=/mnt/c/Users/90621  # 替换为你的Windows用户路径
export APP_ENV=wsl

# 保存退出后，编辑用户环境变量文件
vi ~/.bash_profile

# 添加同样的APP_ENV设置
export APP_ENV=wsl

软件安装

脚本安装（推荐）

通过脚本可快速安装Nginx、PHP、MySQL等软件，支持从Docker复制预编译软件或通过APT源安装：

bash
# 查看帮助信息
lnmp-wsl-install.sh

# 安装指定软件（例如安装nginx和php）
lnmp-wsl-install.sh nginx php

PHP多版本管理

bash
# 启用特定PHP版本（如PHP 7.2）
lnmp-wsl-install.sh enable php72

# 启用其他版本
lnmp-wsl-install.sh enable php71 | php70 | php56

PHP安装路径：

• 执行文件：/usr/local/bin（主版本），其他版本需使用绝对路径
• 配置文件：/usr/local/etc/phpXX（XX为版本号，如php72）
• 日志文件：/var/log/phpXX

Nginx配置

必须在Nginx主配置文件/etc/nginx/nginx.conf的http块中添加以下配置，否则PHP页面加载缓慢：

nginx
http {
  ...
  
  fastcgi_buffering off;
  
  ...
}

文件链接设置

假设LNMP目录位于用户主目录，执行以下命令建立配置文件链接：

bash
# 链接Nginx配置
sudo ln -sf $WSL_HOME/lnmp/wsl/nginx/ /etc/nginx/conf.d

# 链接PHP-FPM配置（以PHP 7.2为例）
sudo ln -sf $WSL_HOME/lnmp/wsl/php.fpm.zz-wsl.conf /usr/local/php72/etc/php-fpm.d/zz-wsl.conf

# 复制MySQL配置
sudo cp -f $WSL_HOME/lnmp/wsl/mysql.wsl.cnf /etc/mysql/conf.d/wsl.cnf

MySQL配置

安装注意事项

不建议直接使用apt install mysql-server（会安装MariaDB），需手动配置MySQL APT源：

• 参考：[***]

初始化与远程登录

• Debian MySQL初始化指南：[***]
• MySQL远程登录配置：[***]

快捷启动脚本

使用以下脚本控制服务的启动、重启和停止：

bash
# 启动/重启/停止所有服务或指定服务
lnmp-wsl.sh start | restart | stop [服务名 or all]

# 示例：启动所有服务
lnmp-wsl.sh start all

# 示例：重启Nginx
lnmp-wsl.sh restart nginx

WSL中运行Docker CLI

通过以下脚本在WSL中配置并运行Docker CLI：

bash
lnmp-wsl-docker-cli.sh

PHP扩展列表

已安装的PHP扩展（可通过php -m查看完整列表）：

• bcmath
• bz2
• calendar
• com_dotnet
• ctype
• curl
• date
• dba
• dom
• enchant
• exif
• ext_skel
• ext_skel_win32.php
• fileinfo
• filter
• ftp
• gd
• gettext
• gmp
• hash
• iconv
• imap
• interbase
• intl
• json
• ldap
• libxml
• mbstring
• mysqli
• mysqlnd
• oci8
• odbc
• opcache
• openssl
• pcntl
• pcre
• pdo
• pdo_dblib
• pdo_firebird
• pdo_mysql
• pdo_oci
• pdo_odbc
• pdo_pgsql
• pdo_sqlite
• pgsql
• phar
• posix
• pspell
• readline
• recode
• reflection
• session
• shmop
• simplexml
• skeleton
• snmp
• soap
• sockets
• sodium
• spl
• sqlite3
• standard
• sysvmsg
• sysvsem
• sysvshm
• tidy
• tokenizer
• wddx
• xml
• xmlreader
• xmlrpc
• xmlwriter
• xsl
• zend_test
• zip
• zlib

注意事项

1. 配置文件操作前请备份原文件
2. 环境变量设置需确保Windows和WSL端均正确配置
3. PHP多版本使用时，非主版本需使用绝对路径调用
4. Nginx必须添加fastcgi_buffering off配置，否则影响PHP性能
5. 详细编译安装指南：[***]
6. 镜像标签信息：[***]