utopia-php/migration

A simple library to migrate resources between services.

0.4.0 2024-02-25 12:35 UTC

Requires

• php: 8.*
• appwrite/appwrite: 10.1.0
• utopia-php/cli: 0.*

Requires (Dev)

• laravel/pint: 1.*
• phpunit/phpunit: 9.*
• vlucas/phpdotenv: 5.*

MIT

• framework
• php
• migration
• upf
• utopia

README

Utopia Migration is a simple and lite library to migrate and transform resources inbetween services. This library is aiming to be as simple and easy to learn and use. This library is maintained by the Appwrite team.

Although this library is part of the Utopia Framework project it is dependency free and can be used as standalone with any other PHP project or framework.

Getting Started

Install using composer:

composer require utopia-php/migration

Init in your application:

<?php

use Utopia\Migration\Transfer;
use Utopia\Migration\Sources\NHost;
use Utopia\Migration\Destinations\Appwrite;

require_once __DIR__ . '/../../vendor/autoload.php';

// Initialize your Source
$source = new NHost('db.xxxxxxxxx.nhost.run', 'database-name', 'username', 'password');

// Initialize your Destination
$destination = new Appwrite('project-id', 'https://cloud.appwrite.io/v1', 'api-key');

// Initialize Transfer
$migration = new Transfer($source, $destination);

// Transfer the resource groups you want
$transfer->run(
    [
        Transfer::GROUP_AUTH
    ], function ($status) {
        echo $status['message'] . PHP_EOL;
    }
);

Supported Resources Chart

Sources:

	Auth	Databases	Storage	Functions	Settings
Appwrite	✅	✅	✅	✅
Supabase	✅	✅	✅
NHost	✅	✅	✅
Firebase	✅	✅	✅

Destinations:

	Auth	Databases	Storage	Functions	Settings
Appwrite	✅	✅	✅	✅
Local	✅	✅	✅	✅	✅

Warning The Local destination should be used for testing purposes only. It is not recommended to use this destination in production or as a backup. The local destination is there to confirm that a source is working correctly and to test the migration process with needing a target destination instance. This may change in the future however as the library matures.

System Requirements

Utopia Migration requires PHP 8.0 or later. We recommend using the latest PHP version whenever possible.

Copyright and license

The MIT License (MIT) http://www.opensource.org/licenses/mit-license.php