PHP微信小程序部署到服务器完整指南
结论与核心观点
PHP微信小程序的服务器部署主要包括环境配置、代码上传、域名绑定和HTTPS设置等步骤,关键在于确保服务器环境兼容、接口可访问且符合微信安全要求。以下是详细流程:
部署步骤
1. 服务器环境准备
- 操作系统:推荐Linux(如CentOS/Ubuntu),兼容性更好。
- Web服务器:
- Apache/Nginx(推荐Nginx,性能更高)。
- 安装命令示例(Ubuntu):
sudo apt install nginx php-fpm mysql-server
- PHP环境:
- 版本需≥7.0(微信小程序要求HTTPS,PHP需支持cURL等扩展)。
- 安装扩展:
sudo apt install php-mysql php-curl php-gd php-mbstring
2. 代码上传与配置
- 上传方式:
- 通过FTP/SFTP(如FileZilla)或Git直接部署到服务器。
- 代码目录通常放在
/var/www/html/
(Nginx默认路径)。
- 权限设置:
chmod -R 755 /var/www/html/ chown -R www-data:www-data /var/www/html/
3. 域名与HTTPS配置
- 域名绑定:
- 在域名解析服务商(如阿里云)将域名A记录指向服务器IP。
- Nginx配置示例:
server { listen 80; server_name yourdomain.com; root /var/www/html; index index.php; }
- HTTPS证书:
- 必须项:微信小程序要求后端接口使用HTTPS。
- 免费证书:通过Let’s Encrypt获取:
sudo apt install certbot python3-certbot-nginx sudo certbot --nginx -d yourdomain.com
4. 数据库配置
- 创建数据库和用户(MySQL示例):
CREATE DATABASE weapp_db; GRANT ALL PRIVILEGES ON weapp_db.* TO 'weapp_user'@'localhost' IDENTIFIED BY 'password';
- 导入SQL文件(如有):
mysql -u root -p weapp_db < dump.sql
5. 微信小程序配置
- 后台接口地址:在小程序后台(https://mp.weixin.qq.com)填写HTTPS接口URL(如
https://yourdomain.com/api.php
)。 - 域名白名单:确保小程序后台已添加服务器域名(包括子域名)。
6. 测试与调试
- 接口测试:
- 使用Postman或浏览器访问接口,检查返回数据。
- 常见错误:
- 500错误:检查PHP日志(
/var/log/php_errors.log
)。 - 403错误:Nginx/Apache权限问题。
- 小程序端联调:
- 开启开发者工具的“不校验合法域名”临时测试。
核心注意事项
- HTTPS是强制要求,否则小程序无法访问接口。
- 接口返回格式需为JSON,微信小程序默认解析JSON数据。
- 安全防护:
- 过滤用户输入,防止SQL注入。
- 使用微信提供的
session_key
校验用户身份。
总结
PHP微信小程序部署的核心是环境配置、HTTPS证书和接口调试。完成上述步骤后,你的小程序即可正常访问服务器数据。如果遇到问题,优先检查Nginx/Apache日志和微信开发者工具控制台报错。