IT技术社区_专业开发者平台_最新编程教程与解决方案 -沐辰社区

PHP项目运维与交接手册

wen PHP项目 242

PHP项目运维与交接手册

文档说明

1 目的

本手册旨在规范PHP项目的运维流程和交接标准，确保项目能够稳定运行,并在人员变动时实现平滑过渡。

PHP项目运维与交接手册

2 适用范围

适用于所有基于PHP开发的Web项目,包括但不限于：

  • Laravel / Symfony / ThinkPHP 框架项目
  • 自定义PHP应用
  • WordPress / Drupal 等CMS系统

1 基本信息

项目
项目名称 [填写]
项目简介 [填写]
技术栈 PHP版本、框架、数据库、缓存等
部署环境 开发/测试/生产环境信息
服务器信息 IP、SSH访问方式、操作系统

2 关键联系人

角色 姓名 联系方式
项目负责人
运维负责人
后端开发
前端开发

环境配置

1 服务器环境要求

基础环境

- 操作系统：CentOS 7+/Ubuntu 20.04+
- Web服务器：Nginx 1.18+ / Apache 2.4+
- PHP版本：7.4 / 8.0 / 8.1
- 数据库：MySQL 5.7+ / MariaDB 10.3+ / PostgreSQL 12+
- Redis：6.0+

PHP扩展清单

- mbstring
- pdo_mysql
- redis
- gd
- curl
- openssl
- json
- xml
- zip
- bcmath
- [其他扩展]

2 环境变量配置

核心环境变量（.env示例）

APP_NAME=项目名称
APP_ENV=production
APP_DEBUG=false
APP_URL=https://example.com
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=db_name
DB_USERNAME=db_user
DB_PASSWORD=db_password
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379
# 第三方服务配置
MAIL_DRIVER=smtp
MAIL_HOST=smtp.aliyun.com
MAIL_PORT=465
MAIL_USERNAME=xxx@xxx.com
MAIL_PASSWORD=xxx

3 Nginx配置参考

server {
    listen 80;
    server_name example.com;
    return 301 https://$server_name$request_uri;
}
server {
    listen 443 ssl http2;
    server_name example.com;
    root /var/www/project/public;
    index index.php index.html;
    ssl_certificate /etc/nginx/ssl/example.pem;
    ssl_certificate_key /etc/nginx/ssl/example.key;
    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
    location ~ /\.ht {
        deny all;
    }
}

部署流程

1 首次部署

# 1. 克隆代码
git clone git@github.com:org/project.git /var/www/project
# 2. 配置环境
cp .env.example .env
# 编辑 .env 文件，修改数据库、缓存等配置
# 3. 安装依赖
cd /var/www/project
composer install --no-dev --optimize-autoloader
# 4. 生成应用密钥（Laravel）
php artisan key:generate
# 5. 迁移数据库
php artisan migrate --force
# 6. 创建存储链接（Laravel）
php artisan storage:link
# 7. 优化加载
php artisan config:cache
php artisan route:cache
php artisan view:cache
# 8. 设置目录权限
chmod -R 755 storage bootstrap/cache
chown -R www-data:www-data .
# 9. 重启服务
systemctl restart php8.1-fpm
systemctl reload nginx

2 日常更新

# 1. 进入维护模式
php artisan down --retry=60
# 2. 拉取最新代码
git pull origin main
# 3. 更新依赖
composer install --no-dev --optimize-autoloader
# 4. 数据库迁移
php artisan migrate --force
# 5. 清除缓存
php artisan optimize:clear
# 6. 重新优化
php artisan optimize
# 7. 退出维护模式
php artisan up

3 回滚方案

# 版本回滚
git reset --hard HEAD~1
# 数据库回滚
php artisan migrate:rollback --step=1
# 恢复缓存
php artisan optimize

监控与告警

1 日志系统

日志位置

/var/www/project/storage/logs/laravel.log    # 应用日志
/var/log/nginx/access.log                     # Nginx访问日志
/var/log/nginx/error.log                      # Nginx错误日志
/var/log/php8.1-fpm.log                       # PHP-FPM日志
/var/log/mysql/error.log                      # MySQL错误日志

日志轮转配置（/etc/logrotate.d/project）

/var/www/project/storage/logs/*.log {
    daily
    rotate 7
    compress
    delaycompress
    missingok
    notifempty
    create 0640 www-data www-data
    sharedscripts
    postrotate
        systemctl restart php8.1-fpm
    endscript
}

2 关键监控指标

监控项 阈值 告警方式
CPU使用率 > 80% 钉钉/邮件
内存使用率 > 90% 钉钉/邮件
磁盘使用率 > 85% 钉钉/邮件
PHP-FPM进程数 > 配置的80% 钉钉/邮件
数据库连接数 > 200 钉钉/邮件
404/500错误率 > 1% 钉钉/邮件
Redis内存使用 > 100MB 钉钉/邮件
SSL证书过期 30天内 钉钉/邮件

3 常用监控命令

# 查看PHP-FPM状态
php artisan php:fpm-status
# 查看数据库连接
mysqladmin -u root -p status
# 查看Redis状态
redis-cli info stats
# 查看系统负载
top -bn1 | grep "load average"
# 查看磁盘使用
df -h
# 查看内存使用
free -m

备份策略

1 数据库备份

自动备份脚本（/usr/local/bin/backup-db.sh）

#!/bin/bash
BACKUP_DIR="/backup/database"
DATE=$(date +%Y%m%d_%H%M%S)
DB_NAME="project_db"
DB_USER="backup_user"
DB_PASSWORD="xxx"
# 创建备份
mysqldump -u $DB_USER -p$DB_PASSWORD --single-transaction $DB_NAME | gzip > $BACKUP_DIR/$DB_NAME_$DATE.sql.gz
# 删除7天前的备份
find $BACKUP_DIR -name "*.sql.gz" -type f -mtime +7 -delete

定时任务（crontab）

# 每天凌晨3点备份
0 3 * * * /usr/local/bin/backup-db.sh
# 每周日完整备份
0 2 * * 0 /usr/local/bin/backup-full.sh

2 文件备份

# 重要文件备份
tar -czf /backup/files/project_files_$(date +%Y%m%d).tar.gz \
  /var/www/project \
  /etc/nginx/sites-available/project \
  /etc/php/8.1/fpm/php.ini

3 恢复流程

# 数据库恢复
gunzip < backup_20230101.sql.gz | mysql -u root -p project_db
# 文件恢复
tar -xzf backup_files_20230101.tar.gz -C /

应急处理

1 常见问题处理

问题描述 可能原因 解决方案
500 Internal Server Error PHP语法错误/权限问题 查看laravel.log错误日志
数据库连接失败 MySQL服务停止/连接数满 systemctl restart mysql
502 Bad Gateway PHP-FPM进程卡死 systemctl restart php8.1-fpm
磁盘空间不足 日志文件过大/临时文件 清理日志/临时文件
网站访问慢 大量并发/慢查询 查看慢查询日志/增加缓存
Session登录失效 Redis连接失败 检查Redis状态/重启Redis

2 紧急恢复脚本

#!/bin/bash
# emergency_recovery.sh
# 重启所有服务
systemctl restart php8.1-fpm
systemctl restart nginx
systemctl restart mysql
systemctl restart redis
# 清理缓存
cd /var/www/project
php artisan cache:clear
php artisan config:clear
php artisan view:clear
php artisan route:clear
# 检查服务状态
systemctl status php8.1-fpm
systemctl status nginx
systemctl status mysql
systemctl status redis

交接清单

1 交接检查表

  • [ ] 项目README文档已更新
  • [ ] 环境配置文档完整
  • [ ] 部署文档可执行
  • [ ] 数据库结构文档
  • [ ] API接口文档
  • [ ] 运维脚本说明
  • [ ] 第三方服务账号密码
  • [ ] SSL证书信息
  • [ ] 域名解析记录
  • [ ] CDN配置信息
  • [ ] 监控系统配置
  • [ ] 日志分析工具配置
  • [ ] 备份策略说明
  • [ ] 应急预案

2 账号密码清单

服务 地址/URL 账号 密码/密钥 备注
云服务器 2.3.4 root xxx
数据库 0.0.1:3306 root xxx
Redis 0.0.1:6379 xxx
代码仓库 github.com/org xxx@xx.com Token:xxx
邮件服务 smtp.xx.com notify@xx xxx
短信服务 api.aliyun.com AK:xxx SK:xxx
监控系统 monitor.xx.com admin xxx

3 交接培训内容

  1. 代码仓库

    • 分支管理策略
    • 代码审查流程
    • 版本发布流程

  2. 服务器管理

    • SSH连接方式
    • 基本运维命令
    • 日志查看方法

  3. 数据库管理

    • 数据备份恢复
    • 慢查询分析
    • 表结构变更流程

  4. 监控告警

    • 告警规则配置
    • 告警响应流程
    • 监控面板使用

  5. 日常运维

    • 部署流程
    • 升级流程
    • 回滚流程

附录

1 常用命令速查

# PHP相关
php -v                    # 查看PHP版本
php -m                    # 查看已安装扩展
php artisan list          # 列出所有Artisan命令
# Composer相关
composer --version        # 查看Composer版本
composer dump-autoload    # 重新生成自动加载
# Git相关
git status                # 查看状态
git log --oneline         # 查看提交历史
git diff                  # 查看差异
# 服务器相关
netstat -tlnp             # 查看端口
ps aux | grep php         # 查看PHP进程
top                       # 实时系统监控
htop                      # 增强版监控

2 安全检查清单

  • [ ] 所有默认密码已修改
  • [ ] SSH密钥认证已配置
  • [ ] 防火墙规则已配置
  • [ ] HTTPS已启用
  • [ ] 文件上传限制已配置
  • [ ] SQL注入防护已启用
  • [ ] XSS防护已启用
  • [ ] CSRF防护已启用
  • [ ] 安全更新已检查
  • [ ] 错误信息显示已关闭

3 版本说明

版本号 更新日期 更新人
v1.0.0 2024-01-01 张三 初始版本
v1.1.0 2024-06-01 李四 新增监控配置章节
v1.2.0 2024-12-01 王五 更新应急处理流程

注意：本手册中的敏感信息（密码、密钥等）需在实际使用前进行替换,并妥善保管。

版权声明：NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播

上一篇PHP项目培训与知识转移

下一篇PHP项目验收与UAT测试

相关文章

抱歉，评论功能暂时关闭!

友情链接攻略窝 · 礼包窝 · 配置窝 · 换算窝 · 算法窝 · 查文窝 · 手册窝 · 问答窝 · 全文搜 · 手册库
相关站点礼包窝 · 查文窝