微擎不是微服务架构，而是单体php应用，xampp无法运行“微擎微服务”；其模块化是逻辑分层而非进程隔离，缺乏服务发现、api网关等微服务必备机制，且apache+php-cgi模式不支持多端口监听与独立生命周期管理。
微擎不是微服务架构，它本质是单体 PHP 应用，XAMPP 无法“运行微擎微服务”——这个前提不成立，强行套用概念会导致配置错乱、调试困难、后续部署脱节。
为什么微擎不能当微服务跑在XAMPP上
微擎代码库中没有服务发现、API网关、独立进程通信机制；所有模块（公众号管理、小程序、多商户）共享同一套 $_SESSION、同一数据库连接、同一 config.php 配置入口。它的“模块化”是逻辑分层，不是进程隔离。XAMPP 提供的 Apache + PHP-CGI 模式天然不支持多服务并行监听不同端口，也无法用 docker-compose 或 systemd 管理其生命周期。
- 你看到的“微擎多模块”，实际是 URL 路由分发到不同控制器，不是独立服务实例
- 试图把微擎拆成多个子项目分别放
htdocs/sub1/、htdocs/sub2/并配虚拟主机，会导致 session 冲突、数据库事务跨域失败、缓存键污染 - 微擎后台的“云服务”“第三方 API 接入”等能力，依赖主应用上下文初始化，剥离后直接报
Class 'We7' not found
本地开发微擎的正确姿势：单体模式 + 环境隔离
真实可落地的做法是保持微擎单体结构，但通过 XAMPP 实现开发/测试环境分离：
- 把微擎源码解压到
D:\xampp\htdocs\we7-dev\（路径不含空格、中文），不要放根目录 - 用 XAMPP 自带的
phpMyAdmin创建专用数据库，字符集强制设为utf8mb4，排序规则选utf8mb4_unicode_ci - 编辑
data/config.local.php，确保$config['db']['host']是'127.0.0.1'（不用localhost，避免 MySQL socket 连接干扰） - 在
php.ini中确认开启extension=php_openssl.dll和extension=php_curl.dll，微擎调用微信接口必用 - 浏览器访问
http://localhost/we7-dev/进安装向导，**不要跳过“检查环境”页**——它会提示fileinfo扩展缺失、gd库未启用等真实问题
XAMPP 启动失败时优先查这三处
Apache 或 MySQL 在 XAMPP 控制面板点 Start 后立刻变红，常见原因和定位方式如下：
-
Apache启动失败：打开D:\xampp\apache\logs\error.log，搜索AH00072（端口被占）或Invalid command 'php_flag'（PHP 模块未加载）。临时解决可改httpd.conf中的Listen 8089，但必须同步改微擎后台“站点设置→域名”里的 HTTP 端口字段 -
MySQL启动失败：检查D:\xampp\mysql\data\mysql_error.log，若含Can't start server : Bind on TCP/IP port，说明 3306 被占用，改my.ini中的port=3307，并立刻更新config.local.php的$config['db']['port'] -
phpMyAdmin 打不开：不是密码问题，而是
config.inc.php里$cfg['Servers'][$i]['port']没同步改，或$cfg['Servers'][$i]['auth_type']错设为cookie却没配blowfish_secret
微擎本地开发最易被忽略的点：它默认关闭 display_errors，出错只显示白屏。必须手动在 index.php 顶部加 ini_set('display_errors', '1'); error_reporting(E_ALL);，否则连语法错误都看不到报错信息。
