本地开发环境配置教程

适用于Windows系统的完整Web开发环境搭建指南

Node.js Python PHP Apache MySQL

目录

Node.js与npm安装配置 Python安装配置 PHP安装配置 Apache安装配置 MySQL安装配置 兼容性注意事项

一、Node.js与npm安装配置

1. 下载

  1. 访问Node.js官方网站：https://nodejs.org/zh-cn/
  2. 推荐下载LTS（长期支持）版本，根据您的系统选择32位或64位安装包

2. 安装步骤

  1. 双击下载的安装包启动安装向导
  2. 点击"Next"，勾选同意许可协议，点击"Next"
  3. 选择安装路径（建议保持默认路径），点击"Next"
  4. 在自定义安装界面，可以保留默认选项，点击"Next"
  5. 点击"Install"开始安装
  6. 安装完成后，点击"Finish"

3. 环境变量配置

Node.js安装程序通常会自动配置环境变量，无需手动操作。可以通过以下步骤验证：

  1. 打开命令提示符（Win+R，输入cmd，按回车）
  2. 输入命令 node -v，如果显示Node.js版本号，则表示环境变量配置成功
  3. 输入命令 npm -v，如果显示npm版本号，则表示npm安装成功

4. 验证方法

  1. 在命令提示符中输入 node -v 查看Node.js版本
  2. 输入 npm -v 查看npm版本
  3. 创建一个简单的JavaScript文件（例如test.js），内容为：
console.log('Hello Node.js!');

在命令提示符中运行 node test.js，如果输出"Hello Node.js!"，则表示Node.js正常运行

二、Python安装配置

1. 下载

  1. 访问Python官方网站：https://www.python.org/downloads/windows/
  2. 选择最新的稳定版本下载（推荐3.9或更高版本）
  3. 根据系统选择32位或64位安装包

2. 安装步骤

  1. 双击下载的安装包启动安装向导
  2. 重要：勾选"Add Python to PATH"选项
  3. 点击"Install Now"进行默认安装，或点击"Customize installation"进行自定义安装
  4. 如果选择自定义安装，保持默认选项即可，点击"Next"
  5. 可以选择安装路径（建议保持默认路径），点击"Install"
  6. 安装完成后，点击"Close"

3. 环境变量配置

如果在安装时勾选了"Add Python to PATH"，则无需手动配置环境变量。否则，需要手动添加：

  1. 右键点击"此电脑"->"属性"->"高级系统设置"->"环境变量"
  2. 在"系统变量"中找到"Path"，点击"编辑"
  3. 点击"新建"，添加Python的安装路径和Scripts文件夹路径（例如：C:\Python39 和 C:\Python39\Scripts）
  4. 点击"确定"保存设置

4. 验证方法

  1. 打开命令提示符，输入 python --version 查看Python版本
  2. 输入 pip --version 查看pip版本（pip是Python的包管理工具）
  3. 输入 python 进入Python交互模式，输入：
print('Hello Python!')

如果输出"Hello Python!"，则表示Python正常运行

输入 exit() 退出Python交互模式

三、PHP安装配置

1. 下载

  1. 访问PHP官方网站：https://windows.php.net/download
  2. 选择与Apache兼容的PHP版本（推荐PHP 8.0或更高版本）
  3. 下载VC15 x64 Thread Safe版本的ZIP文件（与Apache搭配使用需要Thread Safe版本）

2. 安装步骤

  1. 将下载的ZIP文件解压到一个固定目录（例如：C:\php）
  2. 复制一份php.ini-development文件，并重命名为php.ini

3. 配置php.ini文件

  1. 使用文本编辑器打开php.ini文件
  2. 找到 ;extension_dir = "ext"，去掉前面的分号，并将其修改为 extension_dir = "C:\php\ext"（根据实际安装路径调整）
  3. 根据需要启用常用扩展，去掉以下行前面的分号：
;extension=mysqli（用于MySQL连接）
;extension=pdo_mysql
;extension=curl
;extension=gd
;extension=openssl

保存并关闭php.ini文件

4. 环境变量配置

  1. 右键点击"此电脑"->"属性"->"高级系统设置"->"环境变量"
  2. 在"系统变量"中找到"Path"，点击"编辑"
  3. 点击"新建"，添加PHP的安装路径（例如：C:\php）
  4. 点击"确定"保存设置

5. 验证方法

  1. 打开命令提示符，输入 php -v 查看PHP版本
  2. 创建一个简单的PHP文件（例如info.php），内容为：
<?php phpinfo(); ?>

后续与Apache配置完成后，可以通过浏览器访问该文件验证PHP是否正常运行

四、Apache安装配置

1. 下载

  1. 访问Apache Lounge网站：https://www.apachelounge.com/download/
  2. 下载与您的系统和PHP版本兼容的Apache版本（推荐Apache 2.4）
  3. 确保下载的Apache版本与PHP版本兼容（例如，VC15版本的Apache需要搭配VC15版本的PHP）

2. 安装步骤

  1. 将下载的ZIP文件解压到一个固定目录（例如：C:\Apache24）

3. 配置httpd.conf文件

  1. 使用文本编辑器打开C:\Apache24\conf\httpd.conf文件
  2. 找到 Define SRVROOT，确保其值为Apache的安装路径（例如：Define SRVROOT "C:/Apache24"）
  3. 找到 Listen 80，可以根据需要修改端口号（如果80端口已被占用）
  4. 找到 ServerName www.example.com:80，去掉前面的井号，并修改为 ServerName localhost:80
  5. 在文件末尾添加以下内容以配置PHP：
# PHP配置
LoadModule php_module "C:/php/php8apache2_4.dll"
AddHandler application/x-httpd-php .php
PHPIniDir "C:/php"

注意：php8apache2_4.dll的名称可能根据PHP版本有所不同，请根据实际情况调整

保存并关闭httpd.conf文件

4. 安装Apache服务

  1. 以管理员身份打开命令提示符
  2. 切换到Apache的bin目录（例如：
cd C:\Apache24\bin
  1. 输入命令 httpd.exe -k install 安装Apache服务
  2. 输入命令 httpd.exe -k start 启动Apache服务

5. 验证方法

  1. 打开浏览器，访问 http://localhost，如果看到"It works!"页面，则表示Apache服务器正常运行
  2. 将之前创建的info.php文件复制到C:\Apache24\htdocs目录下
  3. 在浏览器中访问 http://localhost/info.php，如果看到PHP信息页面，则表示PHP与Apache配置成功

五、MySQL安装配置

1. 下载

  1. 访问MySQL官方网站：https://dev.mysql.com/downloads/installer/
  2. 下载MySQL Installer for Windows

2. 安装步骤

  1. 双击下载的安装包启动安装向导
  2. 选择"Developer Default"或"Custom"安装类型，点击"Next"
  3. 如果选择"Custom"，可以选择需要安装的组件，至少需要安装MySQL Server和MySQL Workbench
  4. 点击"Next"，解决可能出现的依赖问题，然后点击"Next"
  5. 点击"Execute"开始安装所选组件
  6. 安装完成后，点击"Next"进入配置向导
  7. 在Type and Networking页面，保持默认设置，点击"Next"
  8. 在Authentication Method页面，选择"Use Strong Password Encryption for Authentication"，点击"Next"
  9. 设置root用户密码，点击"Next"
  10. 在Windows Service页面，保持默认设置，点击"Next"
  11. 点击"Execute"应用配置
  12. 配置完成后，点击"Finish"完成安装

3. 环境变量配置

  1. 右键点击"此电脑"->"属性"->"高级系统设置"->"环境变量"
  2. 在"系统变量"中找到"Path"，点击"编辑"
  3. 点击"新建"，添加MySQL的bin目录路径（例如：C:\Program Files\MySQL\MySQL Server 8.0\bin）
  4. 点击"确定"保存设置

4. 验证方法

  1. 打开命令提示符，输入 mysql -u root -p，然后输入安装时设置的root密码
  2. 如果成功进入MySQL命令行界面，则表示MySQL安装成功
  3. 输入 show databases; 查看数据库列表
  4. 输入 exit; 退出MySQL命令行界面
  5. 也可以使用MySQL Workbench连接数据库进行验证

六、各组件间兼容性注意事项

版本兼容性

  • 确保下载的Apache版本与PHP版本兼容（查看PHP下载页面的系统要求）
  • 确保PHP版本与MySQL版本兼容（例如，PHP 8.0支持MySQL 5.6及以上版本）

VC Redistributable兼容性

  • 安装Apache和PHP前，确保已安装对应的Visual C++ Redistributable（可以在Apache Lounge和PHP下载页面找到相关链接）

端口冲突

  • 确保Apache使用的端口（默认80）没有被其他程序占用
  • 确保MySQL使用的端口（默认3306）没有被其他程序占用

文件权限

  • 确保Apache的htdocs目录和PHP的临时目录有正确的读写权限
  • 确保MySQL的数据目录有正确的权限

防火墙设置

  • 确保Windows防火墙允许Apache和MySQL服务通过

七、常见问题及解决方案

通过以上步骤，您应该能够在Windows系统上成功安装并配置完整的Web开发环境。如果在安装过程中遇到问题，可以参考各软件的官方文档或搜索相关解决方案。