Mac Dev Staging_开发编程 skill-PHP中文网

Mac Dev Staging

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

将 macOS 机器变为本地 PHP/MariaDB 暂存服务器，使用 macOS 自带 Apache、Homebrew PHP 8.5、MariaDB、内置 SFTP、npm 工具链以及本地开发环境。

Mac Dev Staging 10

功能概述

Mac Dev Staging 10是一项面向实际任务的技能，主要用于当您想要让 Mac 行为像可重复本地开发或中继服务器时, 请使用此技能；此技能是围绕您在现代 Apple Silic 上实际拥有的堆栈构建的。

核心要点

它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。

使用与执行

从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；

结果检查与注意事项

若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

Mac 开发环境预发布（Staging）配置

当你希望一台 Mac 表现为可重复构建的本地开发或预发布服务器时，请使用本技能。

该技能围绕现代 Apple Silicon Mac 实际具备的软件栈构建：

系统自带的 macOS Apache（/usr/sbin/httpd）
通过 Homebrew 安装的 PHP 8.5
通过 Homebrew 安装的 MariaDB
macOS 内置的 SSH/SFTP
由 npm 管理的 JavaScript 工具链，用于本地构建/测试工作流
一个与主 OpenClaw 网关共存的、仅限开发使用的网关接入面（gateway surface）
可选的 Homebrew nginx

它不假设采用 Linux 风格的包布局，也不假装 Mac 应当完全模拟你的 Ubuntu 网关行为。

适用场景

在 Mac 上进行本地 PHP 预发布环境搭建
Joomla、WordPress、CodeIgniter、Laravel 等 PHP 应用
在系统默认的 macOS Apache 中启用 PHP 8.5
添加 MariaDB 并建立可预测的本地数据库环境
自动生成虚拟主机（vhost）配置文件和 Apache 片段，避免凭记忆手动编辑
通过 SFTP 暴露项目，用于部署、编辑及预发布环境同步
以可复现的方式安装 browser-sync 等 JS 工具链
在不干扰主网关的前提下，测试轻量级 Mac 本地网关/控制器
可选的 nginx 前端代理或旁路（sidecar）本地测试

不适用场景

面向公网的生产环境托管
替代你的主 Linux 网关
明确倾向容器化方案时（如 Docker 优先的本地开发栈）
误以为本技能可绕过 sudo 权限直接修改 /etc/apache2 目录下的配置

现实考量

在 macOS 上，难点不在于安装 PHP 或 MariaDB，而在于使 Apache 配置具备可复现性，且不破坏系统稳定性。

因此，本技能遵循分阶段执行模式：

检测当前系统状态
安装或验证 Homebrew 托管的服务
生成安全的 Apache 配置片段
明确告知操作者哪些步骤需使用 sudo
变更后验证整套技术栈运行状态
若文件部署是工作流的一部分，则验证 SFTP 可用性
保留操作凭证（receipts）与日志，便于自动化与预发布流程审计

工作流

1. 检测当前技术栈

运行：

scripts/detect-stack.sh
scripts/detect-ports.sh

检查内容包括：

系统自带 Apache 的版本
是否已启用虚拟主机（vhosts）
是否通过 Homebrew 安装了 PHP
是否已安装 MariaDB
是否已安装 nginx
当前 brew services 状态
是否存在与主网关或本地 JS 工具链的端口冲突

2. 安装核心软件包

运行：

scripts/bootstrap-brew.sh
scripts/bootstrap-npm-tooling.sh

安装以下组件：

php
mariadb
nginx
本地 npm 工具链（例如 browser-sync）

该步骤不会静默修改 /etc/apache2 下的任何文件。

3. 渲染 Apache + PHP 配置

生成推荐的 Apache PHP 启用配置片段：

scripts/render-apache-php-snippet.sh

生成本地虚拟主机配置：

scripts/render-vhost.sh 
  --server-name mysite.test 
  --docroot /Users/you/Sites/mysite/public

这些脚本会输出应写入以下路径的配置内容：

/etc/apache2/httpd.conf
/etc/apache2/extra/httpd-vhosts.conf

将配置实际写入上述路径仍需使用 sudo 权限。

4. 启用服务

对于 Homebrew 托管的服务：

brew services start php
brew services start mariadb
brew services start nginx

对于系统自带的 Apache：

sudo apachectl restart

若需部署一个与主 Ryzen 网关共存的 Mac 本地开发网关，请先渲染推荐的环境配置：

scripts/render-local-gateway-env.sh

默认规则如下：

主 Ryzen 网关保持绑定于 192.168.88.11:18789
Mac 本地开发网关仅绑定回环地址（loopback）
Mac 本地开发网关使用非冲突的测试端口（如 28789）

5. 验证技术栈

运行：

scripts/verify-stack.sh

验证内容包括：

Apache 是否响应请求
PHP CLI 是否可用
PHP 模块路径是否正确加载
MariaDB 的 Unix socket 或 TCP 端口是否就绪
如预期启用，nginx 是否正在运行
预期的本地端口是否空闲或已被有意占用
本地开发网关测试端口是否与生产网关端口发生冲突

6. 启用并验证 SFTP

对预发布环境而言，SFTP 通常是部署最简路径。

检查当前状态：

scripts/detect-sftp.sh

若“远程登录”（Remote Login）未启用，可通过 macOS 系统设置或以下命令开启：

sudo systemsetup -setremotelogin on

推荐实践：

创建或选用专用的预发布用户
将项目文件置于该用户的家目录下，或置于明确归属的共享路径中
当 SFTP 文件同步已满足需求时，避免授予广泛的 shell 访问权限

在将该 Mac 暴露给局域网内其他设备前，请先阅读 references/sftp-on-macos.md。

7. 凭证记录与控制器操作

本技能假定所有预发布操作均应留痕。

当你需要一个稳定入口点统一管理本地服务控制、构建步骤、验证、端口检查或网关连通性测试时，可使用轻量级控制器：

scripts/controller.sh status
scripts/controller.sh verify
scripts/controller.sh build /Users/you/Sites/mysite build
scripts/controller.sh gateway-ping http://127.0.0.1:28789/

记录操作凭证：

scripts/write-receipt.sh --action "bootstrap-brew" --status ok --detail "Installed php mariadb nginx"
scripts/write-receipt.sh --action "verify-stack" --status ok --detail "Apache php mariadb verified"

凭证记录用途包括：