README

注意

此软件是实验性的，尚未准备好用于生产。它只是一个概念验证。

先决条件

PHP 5.3+
使用Composer安装依赖项

安装依赖项

要将定义的依赖项获取到您的本地项目中，只需运行composer.phar的install命令。

$ php composer.phar install

什么是MySQL Workbench Schema Exporter？

该应用程序旨在创建

Doctrine 2.0 YAML模式，注解类

从MySQL Workbench模型 (*.mwb) 中生成的模式文件。它受到了mysql-workbench-doctrine-plugin的启发。

外键名称

要替换关系名称为外键名称，请以外键名称开头为 "d:"。

命令行界面 (CLI)

有一个新的CLI，名为export.php，用于简化导出过程，您可以在cli文件夹下查看。CLI具有在导出之前自定义导出配置的功能。默认情况下，CLI应用程序将使用当前目录中位于的配置文件export.json来提供参数，如果找到它。要禁用此行为，请参阅下面的选项。

CLI的语法

php cli/export.php [options] FILE [DEST]

其中

选项:
- --export=type，选择导出的结果，目前可用的类型
  - doctrine2-annotation，Doctrine 2.0 注解类
- --config=file，从文件（JSON格式）中读取导出参数
- --saveconfig，将导出参数保存到文件export.json，以后可以作为--config=file的值使用
- --list-exporter，显示所有可用的导出器
- --no-auto-config，禁用自动配置文件查找
- --zip，压缩结果
- --help，显示用法（或抑制任何参数）
FILE，要导出的mwb文件
DEST，目标目录（可选），如果没有指定，则假设为当前目录

示例用法

php cli/export.php --export=doctrine2-annotation example/data/test.mwb ./generated
php cli/export.php --zip example/data/test.mwb

doctrine2-annotation的示例导出参数（JSON）

{
    "export": "doctrine2-annotation",
    "zip": false,
    "dir": "temp",
    "params": {
        "backupExistingFile": true,
        "skipPluralNameChecking": false,
        "enhanceManyToManyDetection": true,
        "bundleNamespace": "",
        "entityNamespace": "",
        "repositoryNamespace": "",
        "useAnnotationPrefix": "ORM\\",
        "useAutomaticRepository": true,
        "indentation": 4,
        "filename": "%entity%.%extension%",
        "quoteIdentifier": false,
        "generateEntitySerialization": false,
        "generateEntityToArray": true
    }
}

导出器选项

通用选项

应用于所有格式化器的通用选项。

缩进

生成代码的缩进大小。
useTabs

使用制表符进行缩进而不是空格。设置此选项将忽略indentation选项
filename

输出文件名格式，使用以下标签 %schema%、%table%、%entity% 和 %extension% 来允许文件名被上下文数据替换。默认为 %entity%.%extension%。
skipPluralNameChecking

跳过检查模型的复数名称，保持原样，适用于非英语表名。默认为 false。
backupExistingFile

如果目标已存在，则在替换内容之前创建备份。默认为 true。
enhanceManyToManyDetection

如果启用，将在生成的代码中添加表之间的多对多关系。默认为 true。
logToConsole

如果启用，将日志输出到控制台。默认为 false。
logFile

如果指定，将日志输出到文件。如果此选项存在，则忽略选项 logToConsole。默认为空。

所有内容的注释行为

{MwbExporter:external}true{/MwbExporter:external}（应用于表、视图）

将表/视图标记为外部，以跳过表/视图代码生成。对于Doctrine，请使用 {d:external}true{/d:external} 代替。

Doctrine 2.0 注释选项列表

useAnnotationPrefix

Doctrine 注解前缀。默认为 ORM\。
useAutomaticRepository

见上述内容。
bundleNamespace

见上述内容。
entityNamespace

见上述内容。
repositoryNamespace

见上述内容。
skipGetterAndSetter

不要生成列的getter和setter。默认为 false。
generateEntitySerialization

生成方法 __sleep()，在实体序列化时仅包含真实列。默认为 true。
quoteIdentifier

如果启用此选项，所有表名和列名都将使用反引号（`）进行引号。当表名或列名包含保留字时非常有用。默认为 false。

Doctrine 2.0 注释的注释行为

{d:bundleNamespace}AcmeBundle{/d:bundleNamespace}（应用于表）

覆盖 bundleNamespace 选项。
{d:m2m}false{/d:m2m}（应用于表）

MySQL Workbench 架构导出器尝试自动猜测哪些表是多对多映射表，并且不会为这些表生成实体类。如果一个表包含恰好两个指向不同表的 foreign key，并且这些表不是多对多映射表，则该表被认为是映射表。

有时这种猜测是错误的。但是，您可以在表的注释中添加一个提示，以表明它不是映射表。只需在表的注释中使用 "{d:m2m}false{/d:m2m}" 即可。
{d:unidirectional}true{/d:unidirectional}（应用于外键）

默认情况下，所有外键都会产生双向关系。如果您只想有一个单向关系，请在外键的注释中添加一个标志。
{d:owningSide}true{/d:owningSide}（应用于外键）

在双向多对多映射表中，关系的一方是随机选择的。如果您将此提示添加到m2m表的某个外键中，您可以定义Doctrine的关系拥有方。
{d:cascade}persist, merge, remove, detach, all{/d:cascade}（应用于外键或字段）

您可以在外键的注释中指定Doctrine级联选项。它将被生成到注释中。（参考）
{d:fetch}EAGER{/d:fetch}（应用于外键）

您可以在外键的注释中指定关系的获取类型。（EAGER或LAZY，Doctrine默认是LAZY）
{d:orphanRemoval}true{/d:orphanRemoval}（应用于外键）

在外键注释中可以设置的另一个选项。（参考）
{d:o2o}true{/d:o2o}（应用于字段）

创建一对一关系。
{d:orphanRemoval}true{/d:orphanRemoval}（应用于字段）

添加orphanRemoval属性。
{d:orderBy}priority=ASC{/d:orderBy}（应用于字段）

用户排序。
{d:skip}true{/d:skip}（应用于字段或表）

跳过字段或表。
{d:generator-strategy}NONE{/d:generator-strategy}（应用于id字段）[AUTO, SEQUENCE, TABLE, IDENTITY, NONE, UUID, CUSTOM]

id的生成策略。
{d:field-mapped}parentCategory{/d:field-mapped}（应用于字段）

覆盖映射字段名称。
{d:field-inversed}childCategories{/d:field-inversed}（应用于字段）

覆盖反向字段名称。
{d:lifecycleCallbacks}postLoad:fnc,prePersist:fnc,postPersist:fnc,preRemove:fnc,postRemove:fnc,preUpdate:fnc,postUpdate:fnc{/d:lifecycleCallbacks}（应用于表）

您可以在表的注释中指定Doctrine生命周期回调选项。它们将被生成到注解中。
{d:type}dateinterval|datetime_with_millisecond{/d:type}（应用于字段）强制数据类型转换

Doctrine 2.0 注解 ZF2 Inputfilter 的附加选项列表

生成实体填充
生成实体getArrayCopy

要求

与PHP 5.3及以上版本兼容。

链接

测试数据库

示例

<?php

// enable autoloading of classes  
$libDir = __DIR__.'/lib';
require_once($libDir.'/MwbExporter/SplClassLoader.php');

$classLoader = new SplClassLoader();
$classLoader->setIncludePath($libDir);
$classLoader->register();

// create bootstrap
$bootstrap = new \MwbExporter\Bootstrap();

// define a formatter and do configuration
$formatter = $bootstrap->getFormatter('doctrine2-annotation');
$formatter->setup(array());

// specify the workbench document to load, output directory, and storage type (zip or file)
$mwbfile = 'myDatabaseModel.mwb';
$outDir = getcwd();
$storage = 'zip';
// load document and export
$document = $bootstrap->export($formatter, $mwbfile, $outDir, $storage);

// show the output
echo sprintf("Saved to %s.\n\n", $document->getWriter()->getStorage()->getResult());

?>

turnaev / mysql-workbench-schema-exporter

维护者

详细信息