vladmeh/zftool

Zend Tool CLI Provider for Zend Framework 1 Mapper Models Generator

ZF1 Tool Mapper models generator

ZF1 Tool Mapper model generator - это утилита для быстрого создания стандарных моделй Вашего приложения с помощью командной строки по шаблону "Data Mapper". Создание таких моделей подробно описана в "Учебнике Zend Framework" на странице "Создание модели и базы данных таблицы"., _(*1)

Установка

Т.к. утилита является расширением Zend Framework 1.X Zend_Tool CLI у Вас должен быть установлен и настроен Zend_Tool CLI. Как установить и настроить Zend_Tool подробно читайте здесь, _(*2)

Git clone, _(*3)

Установка ZF1 Tool Mapper models generator:, _(*4)

cd <project name>/library
git clone https://github.com/vladmeh/Zftool.git

У вас должна получиться следующая структура проекта, _(*5)

<project name>/
    |-- application/
    |-- library/
    |   |-- Zftool/
    |   |   '-- Tool/
    |   |       '-- Project/
    |   |           |-- Context/
    |   |           |   '-- ZF/
    |   |           |       |-- ModelColFile.php
    |   |           |       |-- ModelMapperDirectory.php
    |   |           |       '-- ModelMapperFile.php
    |   |           '-- Provider/
    |   |               |-- Manifest.php
    |   |               '-- ModelMapperProvider.php
    |   |--...
    |-- public/
    |-- ...

Конфигурация Zend_Tool, _(*6)

Если вы еще не сделали этого, настройте каталог для хранения .zf и конфигурационный файл Zend_Tool .zf.ini:, _(*7)

zf --setup storage-directory
zf --setup config-file

Вносим изменения в созданный файл конфигурации .zf.ini, _(*8)

php.include_path = "...;<the path to your project>/library"
autoloadernamespaces.0 = "Zftool_"
basicloader.classes.0 = "Zftool_Tool_Project_Provider_ModelMapperProvider"
basicloader.classes.1 = "Zftool_Tool_Project_Provider_Manifest"

Узнать где находиться файл .zf.ini и его текущие настроки можно командой zf show config, _(*9)

Проверяем установку, _(*10)

zf ? modelmapper

Вы должны увидеть что-то вроде, _(*11)

Zend Framework Command Line Console Tool v1.12.13
Actions supported by provider "Modelmapper"
  Modelmapper
    zf create modelmapper table-name module
    Note: There are specialties, use zf create modelmapper.? to get specific help on them.
    Note: There are specialties, use zf show modelmapper.? to get specific help on them.

Применение

Основные команды, _(*12)

zf create modelmapper Tablename

С помощью нее будут созданы три основных файла модели Вашей таблицы Tablename базы данных., _(*13)

<project name>/
    |-- application/
    |   |-- models/
    |   |   |-- DbTable/
    |   |   |   '-- Tablename.php
    |   |   |-- mappers/
    |   |   |   '-- Tablename.php
    |   |   '-- Tablename.php

Если нужно создать модели в модуле, _(*14)

zf create modelmapper Tablename modulename

Будут созданы модели таблицы Tablename непосредственно в модуле modulename., _(*15)

<project name>/
    |-- application/
    |   |-- modules/
    |   |   |-- modulename/
    |   |   |   |-- models/
    |   |   |   |   |-- DbTable/
    |   |   |   |   |   '-- Tablename.php
    |   |   |   |   |-- mappers/
    |   |   |   |   |   '-- Tablename.php
    |   |   |   |   '-- Tablename.php

Если файлы моделей уже существуют, Вам будет предложено на выбор перезаписать или сделать бекап старого файла, _(*16)

This project already has a Mapper model: ...
Overwrite?(y) Backup old file?(a) Cancel.(n)

Вспомогательные команды, _(*17)

zf create modelmapper.?
Zend Framework Command Line Console Tool v1.12.13
Details for action "Create" and provider "Modelmapper"
  Modelmapper
    zf create modelmapper table-name module
    zf create modelmapper.table-model table-name module
    zf create modelmapper.mapper-model name module
    zf create modelmapper.db-table name actual-table-name module

zf show modelmapper.?
Zend Framework Command Line Console Tool v1.12.13
Details for action "Show" and provider "Modelmapper"
    zf show modelmapper.table-list
    zf show modelmapper.column-list table-name

Создание только основного файла модели models/Tablename.php, _(*18)

zf create modelmapper.table-model table-name module

Создание только Mapper файла модели models/mappers/Tablename.php, _(*19)

zf create modelmapper.mapper-model name module

Создание только DbTable модели models/DbTable/Tablename.php (аналог команды zf create db-table name actual-table-name module force-overwrite), _(*20)

zf create modelmapper.db-table name actual-table-name module force-overwrite

Список имеющихся таблиц в базе данных, _(*21)

zf show modelmapper.table-list

Список полей в таблице базы данных, _(*22)

zf show modelmapper.column-list table-name

License

Copyright (c) 2013 VladMeh, _(*23)

Distributed under the MIT License (MIT-LICENSE.txt), _(*24)