README

What's Magallanes TYPO3 Tasks?

Magallanes TYPO3 Tasks are tasks for easy deployment with Magallanes 3.

Installing

Simply add the following dependency to your project’s composer.json file:

    "require": {
        "teamneusta/magallanes-task-typo3": "^1.2"
    }

Finally you can use Magallanes TYPO3 Tasks in your mage.yml

Tasks

Permission task

This task set all necessary permission for TYPO3

   post-release:
       - 'TeamNeusta\Magallanes\Task\TYPO3\PermissionsTask'

TYPO3 console tasks

Set path to console:

    typo3:
        console: vendor/helhum/typo3-console/Scripts/typo3cms

TYPO3 cache flush task

This task flushed the TYPO3 cache by helhum/typo3-console

Default usage:

    on-deploy:
        - 'TeamNeusta\Magallanes\Task\TYPO3\Console\CacheFlushTask'

Force flush by inline definition:

    on-deploy:
        - 'TeamNeusta\Magallanes\Task\TYPO3\Console\CacheFlushTask': { force-flush-cache: true }

Force flush by global definition:

    typo3:
        force-flush-cache: true
    on-deploy:
        - 'TeamNeusta\Magallanes\Task\TYPO3\Console\CacheFlushTask'

TYPO3 database update schema task

This task update the database schema for TYPO3 by helhum/typo3-console

Default usage (*.add,*.change):

    on-deploy:
        - 'TeamNeusta\Magallanes\Task\TYPO3\Console\DatabaseUpdateSchemaTask'

Update database schema by inline definition:

    on-deploy:
        - 'TeamNeusta\Magallanes\Task\TYPO3\Console\DatabaseUpdateSchemaTask': { database-update-schema-mode: 'destructive' }

Update database schema by global definition:

    typo3:
        database-update-schema-mode: 'destructive'
    on-deploy:
        - 'TeamNeusta\Magallanes\Task\TYPO3\Console\DatabaseUpdateSchemaTask'

TYPO3 install generatepackagestates task (deprecated)

New way to use setup your TYPO3 composer.json with follow scripts

"scripts": {
    "package-states": [
        "@php vendor/helhum/typo3-console/Scripts/typo3cms install:generatepackagestates"
    ],
    "folder-structure": [
        "@php vendor/helhum/typo3-console/Scripts/typo3cms install:fixfolderstructure"
    ],
    "ext-setup": [
        "@php vendor/helhum/typo3-console/Scripts/typo3cms install:extensionsetupifpossible"

    ],
    "post-autoload-dump": [
        "@package-states",
        "@folder-structure",
        "@ext-setup"
    ]
}

Old way to use Default usage (--activate-default=true):

    on-deploy:
        - 'TeamNeusta\Magallanes\Task\TYPO3\Console\InstallGeneratePackagestatesTask'

TYPO3 install fixfolderstructure task

Default usage:

    on-deploy:
        - 'TeamNeusta\Magallanes\Task\TYPO3\Console\InstallFixFolderStructureTask'

TYPO3 install extension setupactive task

Default usage:

    post-release:
        - 'TeamNeusta\Magallanes\Task\TYPO3\Console\ExtensionSetupActiveTask'

Example

magephp:
    log_dir: ./Logs
    composer:
        path: /usr/bin/composer
    typo3:
        console: bin/typo3cms
        force-flush-cache: true
        database-update-schema-mode: '*.add,*.change'
        web-dir: web
    exclude:
        - ./app/typo3temp
        - ./app/fileadmin
        - ./app/uploads
    environments:
        Production:
            user: xxx
            host_path: xxx
            releases: 4
            hosts:
                - xxx
            pre-deploy:
                - composer/install: { flags: '--optimize-autoloader --no-dev --no-interaction --profile' }
            on-deploy:
            on-release:
                - 'TeamNeusta\Magallanes\Task\TYPO3\Console\InstallFixFolderStructureTask'
            post-release:
                - 'TeamNeusta\Magallanes\Task\TYPO3\Console\DatabaseUpdateSchemaTask'
                - 'TeamNeusta\Magallanes\Task\TYPO3\Console\ExtensionSetupActiveTask'
            post-deploy: