Build tools

构建与校验

本页对应独立 supdger/sand-iam 0.8.3 源码与现行构建入口。构建目录、原始日志与审查 ZIP 放在源码仓外。详细操作文档的维护入口统一在本 Wiki。本次源码整改后的后续构建不再复制整套指南；已公开 v0.8.3 的 1053 条目 ZIP 保留原载荷，本轮不重打包或替换发行件。离线操作前取得所选版本对应的指南。

安全的源码检查

在独立仓根目录运行；要求已有 PHP 和仓内冻结运行依赖。下列检查不连接数据库或启动服务：

php tools/check-package-integrity.php
php tools/check-release-payload.php
php tools/generate-sbom.php --check
php tools/build-lifecycle.php --check

每项应正常结束，并说明未检查的范围。通过只表示包文件、依赖声明与 SQL 生成契约一致，不代表安装、业务调用或浏览器验收。

完整发行构建

build-independent-release.php 只接受已提交且干净的独立源码仓，从 Git blob 在两个独立 staging 目录构建相同 ZIP，核对逐条目哈希与冻结依赖契约。输出参数必须是仓外的绝对路径，且目录尚不存在：

php tools/build-independent-release.php /controlled/review/sand-iam-candidate

从真实用户环境选定这个目录；不要照抄 /controlled/ 示例为机器既有路径。输出两份 ZIP 与构建清单。工具不安装、签名、上传或激活前端。提交和发布仍需各自有效授权；工作区有未提交修改时停止正式构建，不将草稿冒充正式工件。

release-build-contract.json 冻结 Composer 锁文件、389 个 vendor 文件、SDK 生成范围与来源摘要。现行策略保留 Git 中的运行依赖字节；更换依赖必须同时更新锁文件与经过独立复构核对的契约，不能只删 vendor。

生命周期与既有结构

build-lifecycle.php --check 在内存生成并核对根与插件 SQL，不写文件；--output 可指定仓外审查目录。只有明确的 --write 才替换源码 SQL。--profile=legacy-0.7.3 是历史嵌入基线，不等于公开版升级起点。

check-existing-schema.php 提供安装器使用的声明校验；它不意味着已核查某个宿主数据库。已有表、升级与恢复的任务路径见 安装与升级。所有数据库写入、服务启停与宿主同步独立核对授权。

开发入口 · 包校验