告别手动修改！如何使用Composer和PHPCRMigrations优雅地管理内容仓库变更

<code class="bash">composer require phpcr/phpcr-migrations</code>

<pre class="brush:php;toolbar:false;"><?php

use PHPCR\Migrations\VersionInterface;
use PHPCR\SessionInterface;

class Version202310271030 implements VersionInterface
{
    public function up(SessionInterface $session)
    {
        // 假设我们需要在根节点下添加一个名为 'my_app_settings' 的无结构节点
        // 并为其设置一个 'welcomeMessage' 属性
        $root = $session->getRootNode();
        if (!$root->hasNode('my_app_settings')) {
            $settingsNode = $root->addNode('my_app_settings', 'nt:unstructured');
            $settingsNode->setProperty('welcomeMessage', 'Hello from PHPCR Migrations!');
            $session->save(); // 别忘了保存会话
            echo "Added 'my_app_settings' node and 'welcomeMessage' property.\n";
        }
    }

    public function down(SessionInterface $session)
    {
        // 撤销up方法中的操作：移除 'my_app_settings' 节点
        $root = $session->getRootNode();
        if ($root->hasNode('my_app_settings')) {
            $root->getNode('my_app_settings')->remove();
            $session->save(); // 别忘了保存会话
            echo "Removed 'my_app_settings' node.\n";
        }
    }
}

<pre class="brush:php;toolbar:false;"><?php

use Symfony\Component\Console\Output\NullOutput;
use PHPCR\Migrations\VersionStorage;
use PHPCR\Migrations\VersionFinder;
use PHPCR\Migrations\Migrator;
use PHPCR\SimpleCredentials;
use Jackalope\RepositoryFactory; // 假设使用Jackalope作为PHPCR实现

// 1. 获取PHPCR会话 (Session)
// 这部分根据你的PHPCR实现和配置会有所不同，这里以Jackalope为例
$factory = new RepositoryFactory();
$repository = $factory->getRepository([
    'jackalope.jackrabbit_uri' => 'http://localhost:8080/server/', // 你的Jackrabbit或PHPCR服务器地址
    'jackalope.workspace' => 'default', // 使用的工作区
]);
$session = $repository->login(new SimpleCredentials('admin', 'admin')); // 使用正确的凭据登录

// 2. 实例化 VersionStorage, VersionFinder 和 Migrator
$storage = new VersionStorage($session);
// 假设你的迁移文件在当前脚本所在目录下的 'migrations' 子目录中
$finder = new VersionFinder([__DIR__ . '/migrations']); 
$versionCollection = $finder->getVersionCollection();
$migrator = new Migrator($session, $versionCollection, $storage);

// 3. 执行迁移操作
// 首次安装项目时，可能需要初始化已存在的版本，让PHPCR知道当前状态，避免重复执行
// $migrator->initialize(); 

// 迁移到最新版本
echo "Migrating to the latest version...\n";
$migrator->migrate('top', new NullOutput()); // 'top' 表示迁移到所有可用版本的最新一个

// 也可以根据需求执行其他迁移命令：
// $migrator->migrate('202310271030', new NullOutput()); // 迁移到特定版本
// $migrator->migrate('up', new NullOutput());           // 向上迁移一个版本
// $migrator->migrate('down', new NullOutput());         // 向下迁移一个版本
// $migrator->migrate('bottom', new NullOutput());       // 回滚所有已执行的版本

$session->logout(); // 结束会话
echo "Migration complete.\n";