PHPackages                             pantheon-systems/terminus-conversion-tools-plugin - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. pantheon-systems/terminus-conversion-tools-plugin

ActiveTerminus-plugin[Utility &amp; Helpers](/categories/utility)

pantheon-systems/terminus-conversion-tools-plugin
=================================================

Conversion Tools is a Terminus plugin that contain commands to convert a standard Drupal site into a composer managed one.

0.1.6(3y ago)41.1k4[6 issues](https://github.com/pantheon-systems/terminus-conversion-tools-plugin/issues)[3 PRs](https://github.com/pantheon-systems/terminus-conversion-tools-plugin/pulls)MITPHPCI passing

Since Jan 12Pushed 2w ago10 watchersCompare

[ Source](https://github.com/pantheon-systems/terminus-conversion-tools-plugin)[ Packagist](https://packagist.org/packages/pantheon-systems/terminus-conversion-tools-plugin)[ RSS](/packages/pantheon-systems-terminus-conversion-tools-plugin/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependencies (8)Versions (22)Used By (0)

Terminus Conversion Tools Plugin
================================

[](#terminus-conversion-tools-plugin)

[![GitHub Actions](https://github.com/pantheon-systems/terminus-conversion-tools-plugin/actions/workflows/workflow.yml/badge.svg)](https://github.com/pantheon-systems/terminus-conversion-tools-plugin/actions/workflows/workflow.yml)[![Early Access](https://camo.githubusercontent.com/fad0df4a45ea3acf1140d2d58284c225b6b31ed724f49a5dfe0cff8781bc3844/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f50616e7468656f6e2d4561726c795f4163636573732d79656c6c6f773f6c6f676f3d70616e7468656f6e26636f6c6f723d464644433238)](https://pantheon.io/docs/oss-support-levels#early-access)

[![Terminus 3.x Compatible](https://camo.githubusercontent.com/715e88dea3a3486cdd174c810166749c96424eb67d072a342bd4507f89cb4647/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7465726d696e75732d332e782d677265656e2e737667)](https://github.com/pantheon-systems/terminus/tree/3.x)

The main purpose of the Conversion Tools project is to ease the conversion of a Drupal based site into a Pantheon composer managed Drupal site. With this plugin you could do things such as:

- Convert an existing Drupal site to a composer managed Drupal site
- Enable Integrated Composer for a site in a non-official upstream
- Import a site from a external hosting platform to Pantheon
- Update from a Pantheon deprecated upstream to the current supported upstream

Installation
------------

[](#installation)

To install this plugin using Terminus 3:

```
terminus self:plugin:install terminus-conversion-tools-plugin

```

Usage
-----

[](#usage)

This plugin adds the following Terminus commands:

- `conversion:advise`
- `conversion:composer`
- `conversion:create-project`
- `conversion:convert-upstream-from-site`
- `conversion:enable-ic`
- `conversion:import-site`
- `conversion:push-to-multidev`
- `conversion:release-to-dev`
- `conversion:restore-dev`
- `conversion:update-from-deprecated-upstream`
- `conversion:upgrade-d9`
- `conversion:validate-gitignore`

### conversion:advise

[](#conversionadvise)

Run `terminus conversion:advise` to analyze the current state of the site and give advice on the next steps

#### Options:

[](#options)

- skip-upgrade-checks: Skip checks for PHP version and composer/upstream updates.

conversion:composer
-------------------

[](#conversioncomposer)

Run `terminus conversion:composer` to convert a site into a Drupal site managed by Composer. This command could be used to convert a site from the following states:

- drupal8 upstream
- empty upstream
- Build Tools based site
- Custom upstream based site

#### Options:

[](#options-1)

- branch: The target branch name for the multidev environment.
- dry-run: Skip creating the multidev environment and pushing the `composerified` branch
- ignore-build-tools: If used on a Build Tools based site, this command will ignore the Build Tools setup, act like it does not exist and will remove it.
- run-updb: Run drush updb after conversion
- run-cr: Run drush cr after conversion

### conversion:create-project

[](#conversioncreate-project)

Run `terminus conversion:create-project` to create a Pantheon site from a Drupal distribution.

#### Options:

[](#options-2)

- composer-options: Extra composer options.
- label: Site label.
- org: Organization name to create this site in.
- region: Region to create this site in.

### conversion:convert-upstream-from-site

[](#conversionconvert-upstream-from-site)

Run `terminus conversion:convert-upstream-from-site` to convert an exemplar site to an upstream.

### Options:

[](#options-3)

- commit-message: The commit message to use when pushing to the target branch.
- repo: Upstream repo to push to. If omitted, it will look in composer extra section.

### conversion:enable-ic

[](#conversionenable-ic)

Run `terminus conversion:enable-ic` to enable Pantheon Integrated Composer for the site.

### Options:

[](#options-4)

- branch: The target branch name for the multidev environment.
- run-cr: Run drush cr after conversion

### conversion:import-site

[](#conversionimport-site)

Run `terminus conversion:import-site` to create a site based on "drupal-composer-managed" upstream from imported code, database, and files.

#### Options:

[](#options-5)

- overwrite: Overwrite files on archive extraction if exists.
- org: Organization name for a new site.
- site-label: Site label for a new site.
- region: Specify the service region where the site should be created. See [documentation](https://pantheon.io/docs/regions#available-global-regions) for valid regions.
- code: Import code.
- code\_path: Import code from specified directory. Has higher priority over "path" argument.
- db: Import database.
- db\_path: Import database from specified dump file. Has higher priority over "path" argument.
- files: Import Drupal files.
- files\_path: Import Drupal files from specified directory. Has higher priority over "path" argument.
- run-cr: Run `drush cr` after conversion.

### conversion:push-to-multidev

[](#conversionpush-to-multidev)

Run `terminus conversion:push-to-multidev` to push the converted site to a multidev environment.

#### Options:

[](#options-6)

- branch: The target branch name for the multidev environment.
- run-updb: Run drush updb after conversion
- run-cr: Run drush cr after conversion

### conversion:release-to-dev

[](#conversionrelease-to-dev)

Run `terminus conversion:release-to-dev` to release a converted Drupal site managed by Composer to the dev environment.

#### Options:

[](#options-7)

- branch: The target branch name for the multidev environment.
- run-updb: Run drush updb after conversion
- run-cr: Run drush cr after conversion

### conversion:restore-dev

[](#conversionrestore-dev)

Run `terminus conversion:restore-dev` to restore the dev environment branch to its original state.

#### Options:

[](#options-8)

- run-cr: Run drush cr after conversion

### conversion:update-from-deprecated-upstream

[](#conversionupdate-from-deprecated-upstream)

Run `terminus conversion:update-from-deprecated-upstream` to convert a "drupal9" or "drupal-recommended" upstream-based site into a "drupal-composer-managed" upstream-based one.

#### Options:

[](#options-9)

- branch: The target branch name for the multidev environment.
- dry-run: Skip creating the multidev environment and pushing the `composerified` branch
- run-cr: Run drush cr after conversion
- target-upstream-git-url: The target upstream git repository URL. Defaults to
- target-upstream-git-branch: The target upstream git repository branch. Defaults to main

### conversion:upgrade-d9

[](#conversionupgrade-d9)

Run `terminus conversion:upgrade-d9` to upgrade a Drupal 8 with Integrated Composer to Drupal 9.

#### Options:

[](#options-10)

- branch: The target branch name for multidev env.
- skip-upgrade-status: Skip upgrade status checks.
- dry-run: Skip creating multidev and pushing the branch.
- run-updb: Run `drush updb` after conversion.
- run-cr: Run `drush cr` after conversion.

### conversion:validate-gitignore

[](#conversionvalidate-gitignore)

Run `conversion:validate-gitignore` to validate Git/Composer project and update .gitignore file accordingly

Learn more about Terminus Plugins in the [Terminus Plugins documentation](https://pantheon.io/docs/terminus/plugins)

###  Health Score

35

—

LowBetter than 77% of packages

Maintenance43

Moderate activity, may be stable

Popularity22

Limited adoption so far

Community20

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 95.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~59 days

Recently: every ~77 days

Total

7

Last Release

1278d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b34cc6bd882277b6c6dda19bf6631ae5c3a909fd667c826a15121642cdc051b2?d=identicon)[greg.1.anderson](/maintainers/greg.1.anderson)

![](https://www.gravatar.com/avatar/5a89f5f15357797cbd6ec7833a28626478ae3c0ceb5fa1faa8a26d0960584c65?d=identicon)[pantheon-systems](/maintainers/pantheon-systems)

![](https://www.gravatar.com/avatar/a3e1589b7d73d99e33b88498d8cb135f8481326c1381583c719cb9d2b1ef6c62?d=identicon)[jabxjab](/maintainers/jabxjab)

---

Top Contributors

[![kporras07](https://avatars.githubusercontent.com/u/2217820?v=4)](https://github.com/kporras07 "kporras07 (278 commits)")[![namespacebrian](https://avatars.githubusercontent.com/u/87093053?v=4)](https://github.com/namespacebrian "namespacebrian (5 commits)")[![greg-1-anderson](https://avatars.githubusercontent.com/u/612191?v=4)](https://github.com/greg-1-anderson "greg-1-anderson (3 commits)")[![ccharlton](https://avatars.githubusercontent.com/u/263843?v=4)](https://github.com/ccharlton "ccharlton (2 commits)")[![lowlostrong](https://avatars.githubusercontent.com/u/239265111?v=4)](https://github.com/lowlostrong "lowlostrong (2 commits)")

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/pantheon-systems-terminus-conversion-tools-plugin/health.svg)

```
[![Health](https://phpackages.com/badges/pantheon-systems-terminus-conversion-tools-plugin/health.svg)](https://phpackages.com/packages/pantheon-systems-terminus-conversion-tools-plugin)
```

###  Alternatives

[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

103519.9k53](/packages/friendsoftypo3-content-blocks)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

21866.0M1.7k](/packages/drupal-core)[tempest/framework

The PHP framework that gets out of your way.

2.2k34.4k15](/packages/tempest-framework)[drupal/core-recommended

Locked core dependencies; require this project INSTEAD OF drupal/core.

6942.5M420](/packages/drupal-core-recommended)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k5.9M737](/packages/sylius-sylius)[phpro/grumphp

A composer plugin that enables source code quality checks.

4.3k16.7M1.0k](/packages/phpro-grumphp)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
