PHP源码

“源码能不能直接给我？”这个问题几乎每单都会碰到。问的人多半以为源码就是几个文件夹，拷走就能跑。遇到过的实际情况是，一套能跑起来的建站源码，背后牵着数据库、运行环境、伪静态规则和一堆配置项，少一环就白屏。这里把PHP源码从拿到手到在自己服务器上跑通的过程拆开讲，按这个顺序走，少走弯路。

运行环境先配齐，别急着传文件

拿到源码包先别往服务器上扔。PHP 程序对版本敏感，同一套代码在 7.4 和 8.2 上表现可能完全不同，扩展缺一个就报错。这一步花 1 到 2 天把环境对齐，比后面满屏报错回头找原因省事得多。

PHP 版本与扩展的核对方法

打开源码包里的说明文件或者 composer.json，里面一般会写明低至 PHP 版本要求。以主流建站系统为例，多数在 PHP 7.4 到 8.1 之间运行稳定，低于 7.4 会遇到函数废弃警告，高于 8.2 又可能出现兼容问题。版本确认后按需开启扩展，常用的是 mysqli 或 pdo_mysql、gd、curl、mbstring、fileinfo、openssl 这几项，缺 gd 会导致验证码和缩略图生成失败，缺 fileinfo 会让上传功能直接失效。

数据库也提前定好。MySQL 5.7 和 8.0 在字符集默认值上有差别，导入 SQL 文件时 utf8mb4 要显式指定，否则中文和表情符号存进去会变成乱码。用宝塔面板的话，建网站时直接把 PHP 版本和数据库版本选好，比手动编译省时间。

目录权限与伪静态配置

上传完文件，目录权限先设对。运行目录一般指向 public 或者根目录，写权限只给 runtime、uploads、cache 这类目录，权限值 755 就够，给 777 反而留下安全隐患。伪静态规则也要跟着框架走，ThinkPHP 用带 index.php 重写的那套，Laravel 用另一套，配错了除了首页其他页面全是 404。网站配置文件里的根目录路径写错一个层级，同样打不开。

安装环节的正确走法

环境齐了再跑安装程序。多数 PHP 建站系统带 install 目录，浏览器访问域名加 /install 就能进入向导。这里最容易出问题，顺序和参数都得对。

数据库导入与配置写入

先在数据库里建一个空库，字符集选 utf8mb4。安装向导会要求填数据库地址、库名、用户名和密码，主机名本地一般是 localhost，如果是独立数据库服务器就填对应 IP。填完提交，向导自动写入 config 目录下的配置文件。之后导入附带的 SQL 数据文件，导入时留意表前缀，源码里写的是哪个前缀，SQL 文件里就得是哪个，前缀不匹配会提示表不存在。导入完成删除 install 目录，这一步不做等于把安装入口留在线上。

管理员账号与初始设置的清理

安装最后一步设置后台管理员账号，密码建议用字母加数字 10 位以上，别用 admin 这类默认名。装完登录后台，把网站名称、域名、上传大小限制、时区这些基础项逐条过一遍。这一步顺带核一次文件完整性，源码包解压后目录结构应该和说明文档对得上，缺文件当时就补，别等上线报错再回头找。

上线前的功能自测清单

跑通不等于能用。功能逐个点一遍，问题当场记下来集中处理，比上线后被动救火强。按经验这一步留 1 到 2 天比较合适。

• 前台页面逐个访问：首页、栏目页、内容详情页、搜索页，确认没有白屏和 404，图片正常加载。
• 后台增删改查走一遍：发一篇文章、传一张图、改一次栏目，看数据是否正确落库、缓存是否及时刷新。
• 表单提交测试：留言、注册、评论各提交一次，确认入库成功、邮件或短信通知能收到。
• 伪静态与移动端：关掉浏览器缓存重开，检查分页链接是否正常，手机浏览器打开看排版有没有错位。

关于源码交接时哪些文件必须一并拿到、哪些可以后期补，在《网站源码》里专门梳理过清单，拿到包之后可以对照核一遍，避免后期二次开发时缺东西。

二次开发前的准备动作

功能跑通后如果还要改，先别急着动代码。一套没摸清结构的 PHP 项目，改一处崩三处是常事。

代码结构与入口文件

先找到入口文件，一般是 public/index.php 或者根目录的 index.php，顺着它看框架怎么加载路由、控制器和模板。主流框架的目录分工比较清晰，控制器放业务逻辑，模型管数据表操作，视图负责输出。把这些位置认清楚，再动手改对应文件，比全局搜索替换安全。配置项集中在 config 目录，数据库、缓存、上传路径都在这，改之前先备份一份。

版本管理与改动留痕

二次开发前把原始包完整备份，包括数据库导出文件。有条件就上 Git，哪怕只在本地建个仓库，每次改动提交一次，出问题能回退到某个能跑的版本。改代码时在关键位置加注释说明改了什么、为什么改，几个月后自己回头看也能接上。模板文件改动尤其要留痕，换一版设计很容易把原有变量名改丢。

交付与长期可维护性

最后这一步容易被忽略。跑起来是一回事，三五年后还能不能维护是另一回事。判断一套PHP源码值不值得长期用，看三点：文档是否完整、社区是否活跃、代码里有没有明显的硬编码。硬编码多意味着换个域名、换个目录都要改代码，维护成本跟着上去。

交付时把源码、数据库文件、部署说明、账号密码清单一起归档，交给谁都能接手。花几千块做的站，源码捏在自己手里，后面换服务商、加功能、迁移服务器都自由；拿不到源码，等于把主动权交出去。这个判断，比省几千块重要。