PHPackages hetzerok/sam - 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. [Database & ORM](/categories/database) 4. / 5. hetzerok/sam ActiveLibrary[Database & ORM](/categories/database) hetzerok/sam ============ Standalone migrations for MySQL. No ORM requires. No manual schema creation. 0.0.5(9y ago)460MITPHPPHP >=5.5.9 Since Apr 26Pushed 8y ago2 watchersCompare [ Source](https://github.com/hetzerok/sam)[ Packagist](https://packagist.org/packages/hetzerok/sam)[ RSS](/packages/hetzerok-sam/feed)WikiDiscussions master Synced 2w ago READMEChangelog (4)Dependencies (2)Versions (5)Used By (0) SAM (StandAlone Migrations) =========================== [](#sam-standalone-migrations) Описание -------- [](#описание) Компонент предназначен для создания и управления миграциями БД без зависимости от какого-либо фреймворка. Поддерживает MySQL 5.5+, использует PHP 5.5+. Позволяет используя привычные инструменты работать c MySQL, а затем на основе существующей таблицы генерировать файлы миграций. В дальнейшем из этих файлов можно полностью восстановить структуру БД ил её данные до любой созданной ранее версии. Установка и настройка --------------------- [](#установка-и-настройка) ### Установка из исходников: [](#установка-из-исходников) 1. Скачайте файлы компонента или клонируйте репозиторий. 2. Запустите команду `composer update` чтобы установить зависимости. 3. На основе файла `config.inc.sample.php` создайте файл `config.inc.php`, используя свои настройки. 4. ...profit ### Установка через composer [](#установка-через-composer) 1. Выполните команду `composer require hetzerok/sam` - в результате установится компонент и все его зависимости. 2. Скопируйте файл `vendor/hetzerok/sam/run.php` в удобное для запуска место. 3. На основе файла `vendor/hetzerok/sam/config/config.inc.sample.php` создайте файл `config.inc.php`, используя свои настройки и поместите их в удобную для вас директорию 4. Внесите изменения в файл `run.php`: 9 строка: ``` require __DIR__.'/vendor/autoload.php'; ``` пропишите свой путь до автолодера. 17 строка: ``` $config = Config::getInstance('config/'); ``` пропишите свой путь до файла `config.inc.php`. Комады ------ [](#комады) Для работы с CLI требуется выполнить файл `run.php` через консоль. При запуске будет показан набор доступных команд. - `migrations:initialize` - инициализация системы миграций и создание первой миграции. - `migrations:generate` - создание миграции (кроме инициилизирующей) - `migrations:migrate` - применение миграций. Принимает опцию `--last`, при помощи которой передаётся ключ последней накатываемой миграции. Схема работы ------------ [](#схема-работы) Вы устанавливаете компонент, инициализируете систему командой `migrations:initialize`, вносите изменения в бд любым удобным вам способом. Когда приходит момент зафиксировать этап разработки используете команду `migrations:generate`. Миграции можно хранить с помощью VCS или передавать любым удобным способом. При возникновении необходимости обновить структуру используется команда `migrations:migrate`. Настройки в файле `config.inc.php` ---------------------------------- [](#настройки-в-файле-configincphp) #### Параметры соединения С БД [](#параметры-соединения-с-бд) - `username` - Имя пользователя БД - `password` - Пароль пользователя БД - `dsn` - DSN строка для соединения с БД c помощью PDO #### Общие параметры [](#общие-параметры) - `import_data` - (0|1) - Флаг, если включен позволяет использовать миграции для данных - `table_prefix` - Префикс таблиц. Только таблицы с указанным префиксом будут добавляться в миграции. - `conside_foreign_keys` - (0|1) - Флаг, учитывать ли в миграциях внешние ключи. - `conside_indexes` - (0|1) - Флаг, учитывать ли в миграциях индексы. #### Пути и форматы [](#пути-и-форматы) - `migration_path` - Путь к директории с миграциями - `schema_path` - Путь к директории со схемами ( и схемами данных ) - `data_path` - Путь к директории с миграциями данных - `version_format` - (json) - формат хранения файлов версий - `schema_format` - (json) - формат хранения файлов схем - `migration_format` - (json) - формат хранения файлов миграций - `time_format` - формат времени для именования миграций - `local_version_file` - путь к файлу локальной версии (без расширения) - `global_version_file` - путь к файлу глобальной версии (без расширения) - `log_path` - путь к файлу с логами - `log_file` - имя файла логов #### Списки [](#списки) - `import_data_tables` - список таблиц для которых будут создаваться миграции данных. Необхоимо явно указать таблицы (без префикса) для которых нужны такие миграции. .gitignore ---------- [](#gitignore) Если используется VCS GIT, то рекомендую настроить ваш `.gitignore` файл соответствующим образом. В общем случае игнорируйте файл `config.inc.php`, однако оставьте файл `config.inc.sample.php` для примера. Также игнорируте файлы с префиксом local схем и версий. К роме того игнорируйте логи Фичи и баги ----------- [](#фичи-и-баги) - Будут учтены только таблицы с префиксом, который указан в конфиге, если не хотите использовать префикс укажите в качестве значения настройки `table_prefix` пустую строку. - Для того чтобы иметь возможность переименовывать таблицы и столбцы добавляйте к ним комментарий. Пример: вы хотите переименовать таблицу `users` в `my_users`. В начале добавьте комментарий к таблице (любой), выполните команду `migrations:generate` затем переименуйте таблицу и вновь выполните `migrations:generate` в противном случае будет произведено удаление таблицы `users` и создание таблицы `my_users`. - Миграции данных рекомендуется использовать на таблицах с первичным ключем. Это ускоряет запросы и экономит место, так так в таком случае можно однозначно идентифицировать строку по первичному ключу. - На данный момент компонент работает только с кодировкой utf-8 и принудительно при соединении с БД задает команду `SET NAMES utf-8` ### Health Score 26 — LowBetter than 41% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity13 Limited adoption so far Community10 Small or concentrated contributor base Maturity51 Maturing project, gaining track record Bus Factor1 Top contributor holds 86.7% 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 ~31 days Total 3 Last Release 3291d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/1963514?v=4)[Roman Gorbunov](/maintainers/hetzerok)[@hetzerok](https://github.com/hetzerok) --- Top Contributors [![hetzerok](https://avatars.githubusercontent.com/u/1963514?v=4)](https://github.com/hetzerok "hetzerok (13 commits)")[![azernov](https://avatars.githubusercontent.com/u/2388933?v=4)](https://github.com/azernov "azernov (2 commits)") ### Embed Badge ![Health badge](/badges/hetzerok-sam/health.svg) ``` [![Health](https://phpackages.com/badges/hetzerok-sam/health.svg)](https://phpackages.com/packages/hetzerok-sam) ``` ### Alternatives [laravel/framework The Laravel Framework. 34.8k543.8M19.5k](/packages/laravel-framework)[matomo/matomo Matomo is the leading Free/Libre open analytics platform 21.6k38.2k](/packages/matomo-matomo)[mahocommerce/maho Free and open source ecommerce platform, created in 2024 on the M1 platform, PHP 8.3+ 1384.8k32](/packages/mahocommerce-maho)[open-dxp/opendxp Content & Product Management Framework (CMS/PIM) 9417.2k59](/packages/open-dxp-opendxp) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)