PHPackages                             alphacode/simplephp-migrations - 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. [CLI & Console](/categories/cli)
4. /
5. alphacode/simplephp-migrations

ActiveLibrary[CLI & Console](/categories/cli)

alphacode/simplephp-migrations
==============================

CLI para gerenciar migrations no framework SimplePHP

v1.0.0(10mo ago)033MITPHPPHP ^7.4 || ^8.0

Since Jul 8Pushed 10mo agoCompare

[ Source](https://github.com/nelsoncarvalho-alphacode/simplephp-migrations)[ Packagist](https://packagist.org/packages/alphacode/simplephp-migrations)[ RSS](/packages/alphacode-simplephp-migrations/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (2)Used By (0)

🚀 SimplePHP Migrations
======================

[](#-simplephp-migrations)

Ferramenta de linha de comando para gerenciamento de *migrations* em projetos que utilizam o framework **SimplePHP**. Esse pacote permite criar, aplicar, desfazer e validar migrations em ambientes diferentes, de forma rápida e prática.

📦 Instalação
------------

[](#-instalação)

### 🔧 Instalação Global

[](#-instalação-global)

Execute no terminal:

#### composer global require alphacode/simplephp-migrations

[](#composer-global-require-alphacodesimplephp-migrations)

#### Após isso, certifique-se de que o diretório ~/.composer/vendor/bin (ou

[](#após-isso-certifique-se-de-que-o-diretório-composervendorbin-ou)

#### ~/.config/composer/vendor/bin) esteja no seu PATH.

[](#configcomposervendorbin-esteja-no-seu-path)

### 📁 Instalação por projeto

[](#-instalação-por-projeto)

Dentro da raiz do seu projeto, rode:

#### composer require alphacode/simplephp-migrations

[](#composer-require-alphacodesimplephp-migrations)

⚙ Inicialização do Projeto
--------------------------

[](#-inicialização-do-projeto)

Para preparar seu projeto para uso do pacote, execute:

#### simplephp init

[](#simplephp-init)

Esse comando realiza:

- Criação do composer.json (se não existir)
- Instalação do pacote de migrations
- Criação da pasta migrations
- Criação da migration inicial
- Criação da pasta cli/ com os arquivos migrate.php e rollback.php

📚 Comandos disponíveis
----------------------

[](#-comandos-disponíveis)

**- Criar nova migration:**

#### simplephp make:migration NomeDaMigration

[](#simplephp-makemigration-nomedamigration)

**- Executar migrations:**

#### simplephp migrate:dev

[](#simplephp-migratedev)

#### simplephp migrate:mac

[](#simplephp-migratemac)

#### simplephp migrate:hml

[](#simplephp-migratehml)

#### simplephp migrate:prod

[](#simplephp-migrateprod)

**- Rollback da última migration:**

#### simplephp rollback:dev

[](#simplephp-rollbackdev)

#### simplephp rollback:prod

[](#simplephp-rollbackprod)

**- Validar migrations:**

#### simplephp validate

[](#simplephp-validate)

🌍 Ambientes
-----------

[](#-ambientes)

Você pode definir o ambiente pelo comando (ele seta automaticamente a variável CLI\_ENV).

Ambientes disponíveis:

- dev (desenvolvimento)
- mac (ambiente Mac local)
- hml (homologação)
- prod (produção)

📁 Estrutura esperada do projeto
-------------------------------

[](#-estrutura-esperada-do-projeto)

#### /back-office

[](#back-office)

#### ├── cli/

[](#-cli)

#### │ ├── migrate.php

[](#--migratephp)

#### │ └── rollback.php

[](#--rollbackphp)

#### ├── config/

[](#-config)

#### │ ├── db.php

[](#--dbphp)

#### │ └── environments.php

[](#--environmentsphp)

#### ├── migrations/

[](#-migrations)

#### │ └── \_0000\_00\_00\_000000\_init\_project\_structure.php

[](#--_0000_00_00_000000_init_project_structurephp)

#### └── composer.json

[](#-composerjson)

💡 Importante
------------

[](#-importante)

- O arquivo environments.php deve conter as URLs dos ambientes.
- O db.php deve usar $\_SERVER\['HTTP\_HOST'\] para mapear a conexão correta.
- O pacote simula o host de execução CLI para que db.php funcione sem mudanças no projeto existente.
- O pacote **não interfere na lógica já existente** , apenas integra o mecanismo de migrations.

👨💻 Exemplos
-----------

[](#-exemplos)

#### simplephp make:migration criar\_tabela\_usuarios

[](#simplephp-makemigration-criar_tabela_usuarios)

#### simplephp migrate:dev

[](#simplephp-migratedev-1)

#### simplephp rollback:dev

[](#simplephp-rollbackdev-1)

#### simplephp validate

[](#simplephp-validate-1)

🏢
-

[](#)

📧 E-mail:

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance54

Moderate activity, may be stable

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

314d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/87a0750d0b20fa350eb9c828555faa4b17ee4c09070c6436420fa522002f15c0?d=identicon)[nelsoncarvalho-alphacode](/maintainers/nelsoncarvalho-alphacode)

---

Top Contributors

[![nelsoncarvalhosf](https://avatars.githubusercontent.com/u/56328016?v=4)](https://github.com/nelsoncarvalhosf "nelsoncarvalhosf (23 commits)")

### Embed Badge

![Health badge](/badges/alphacode-simplephp-migrations/health.svg)

```
[![Health](https://phpackages.com/badges/alphacode-simplephp-migrations/health.svg)](https://phpackages.com/packages/alphacode-simplephp-migrations)
```

###  Alternatives

[wp-cli/wp-cli

WP-CLI framework

5.1k17.2M320](/packages/wp-cli-wp-cli)[consolidation/annotated-command

Initialize Symfony Console commands from annotated command class methods.

22569.8M19](/packages/consolidation-annotated-command)[seld/cli-prompt

Allows you to prompt for user input on the command line, and optionally hide the characters they type

24725.8M17](/packages/seld-cli-prompt)[illuminate/console

The Illuminate Console package.

12944.1M5.1k](/packages/illuminate-console)[php-tui/php-tui

Comprehensive TUI library heavily influenced by Ratatui

589747.0k6](/packages/php-tui-php-tui)[codedungeon/php-cli-colors

Liven up you PHP Console Apps with standard colors

10210.1M26](/packages/codedungeon-php-cli-colors)

PHPackages © 2026

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