PHPEnv配置Typecho多项目教程

本文详解如何在 Windows 轻量级开发环境 phpEnv 中，通过 PHP 层动态配置（利用 $_SERVER['HTTP_HOST'] 实时识别访问域名），配合 Apache 虚拟主机与 hosts 绑定，实现 Typecho 单份源码、多站点共存——每个站点拥有独立数据库表前缀与配置逻辑，彻底避免重复复制、升级不同步、插件不生效及数据混写等顽疾，让本地多项目开发既高效又安全。

phpEnv 是 Windows 下轻量级的 PHP 开发环境套件，自带 Apache、MySQL 和多个 PHP 版本切换能力，但默认不支持多站点共用同一份 Typecho 源码——直接复制粘贴 config.inc.php 会冲突，硬改 config.inc.php 又无法应对域名动态切换。核心问题在于：Typecho 的配置是静态写死的，而 phpEnv 没有 Nginx 的 location 或宝塔的“多站点独立根目录”机制，必须靠 PHP 层逻辑兜底。

为什么不能直接复制 config.inc.php 到多个子目录

Typecho 安装时生成的 config.inc.php 包含绝对数据库连接信息和表前缀，且被 index.php 强制 require。如果你把同一份 Typecho 源码复制到 D:\phpEnv\www\blog1\ 和 D:\phpEnv\www\blog2\，两个目录各自安装后，blog1/config.inc.php 和 blog2/config.inc.php 确实互不干扰——但这不是“一个程序建多个网站”，而是“多个独立副本”。升级、插件、主题同步维护成本极高。

常见错误现象：

• 修改一个站点的插件，另一个站点没生效
• 更新 Typecho 核心后，必须手动覆盖所有副本
• 共享同一数据库时，表前缀写错导致数据混写（比如都用了 typecho_）

用 $_SERVER['HTTP_HOST'] 动态加载配置

真正复用一份 Typecho 源码的关键，是让 config.inc.php 不再是静态文件，而是一个根据当前访问域名返回不同配置的 PHP 脚本。phpEnv 下 Apache 默认支持 .htaccess，但 Typecho 的伪静态规则（如 pathinfo）本身依赖 mod_rewrite，所以你得先确认 Apache 的 rewrite_module 已启用（在 phpEnv 控制面板 → Apache → Modules 中勾选）。

操作步骤：

• 把 Typecho 源码统一放在 D:\phpEnv\www\typecho\（只放一份）
• 在 D:\phpEnv\www\ 下为每个站点建空目录，例如 blog-a、blog-b
• 在每个空目录里放一个 index.php，内容仅一行：
• 删除原 typecho/config.inc.php，新建 typecho/config.inc.php，内容如下：

<?php
$host = $_SERVER['HTTP_HOST'];
if ($host === 'blog-a.test' || $host === 'www.blog-a.test') {
    $db = new Typecho_Db('Mysql', 'a_');
} elseif ($host === 'blog-b.test' || $host === 'www.blog-b.test') {
    $db = new Typecho_Db('Mysql', 'b_');
} else {
    exit('Unknown host');
}

$db->addServer(array(
    'host'     => 'localhost',
    'user'     => 'root',
    'password' => '',
    'charset'  => 'utf8',
    'port'     => '3306',
    'database' => 'typecho_multi'
), Typecho_Db::READ | Typecho_Db::WRITE);

注意：Typecho_Db 类名首字母大写，旧文档里写的 typecho_db 在新版 Typecho（≥1.2）中已废弃，否则会报 Class 'typecho_db' not found 错误。

Apache 虚拟主机必须显式配置 HostName

phpEnv 自带的 Apache 默认只监听 localhost，不解析自定义域名。你必须手动编辑 D:\phpEnv\Apache\conf\extra\httpd-vhosts.conf，追加：

<VirtualHost *:80>
    ServerName blog-a.test
    DocumentRoot "D:/phpEnv/www/blog-a"
    <Directory "D:/phpEnv/www/blog-a">
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

<VirtualHost *:80>
    ServerName blog-b.test
    DocumentRoot "D:/phpEnv/www/blog-b"
    <Directory "D:/phpEnv/www/blog-b">
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

然后修改系统 C:\Windows\System32\drivers\etc\hosts，添加：

127.0.0.1 blog-a.test
127.0.0.1 blog-b.test

重启 phpEnv 的 Apache 服务。如果不配虚拟主机，浏览器访问 blog-a.test 会直接 404，因为 Apache 根本不知道这个域名该指向哪个目录。

表前缀和数据库权限容易被忽略的点

所有站点共用一个数据库（如 typecho_multi），但必须确保：

• 建库时指定字符集为 utf8mb4（不是 utf8），否则 emoji 和部分中文可能乱码
• 执行 CREATE DATABASE typecho_multi CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
• 用户权限要覆盖所有表前缀，例如用 a_%、b_% 通配，而不是只给 a_* 权限
• 第一次安装任一站点时，务必在安装向导里填对表前缀（a_ 或 b_），否则后续其他站点初始化会失败

最易踩的坑是：以为改了 config.inc.php 就万事大吉，结果忘记在 MySQL 里实际创建对应前缀的表——Typecho 不会自动建表，它只按配置去连、去读，连不上就直接白屏报错 Base table or view not found。

本篇关于《PHPEnv配置Typecho多项目教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！