Skip to content

utopia-php/migration

 
 

Repository files navigation

Utopia Transfer

Build Status Total Downloads Discord

Utopia Transfer is a simple and lite library to transfer 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/transfer

Init in your application:

<?php

use Utopia\Transfer\Transfer;
use Utopia\Transfer\Sources\NHost;
use Utopia\Transfer\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
$transfer = 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 transfer process with needing a target destination instance. This may change in the future however as the library matures.

System Requirements

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

Copyright and license

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