Magento2开发教程 - 如何向数据库添加新表

Magento 2具有特殊的机制，允许你创建数据库表，修改现有的，甚至添加一些数据到他们（如安装数据，已被添加在模块安装）。这种机制允许这些变化可以在不同的设备之间传输。

关键的概念是，而不是做你能做的一次又一次重新安装系统时，手动SQL操作，开发人员创建一个安装（或升级）脚本包含数据。每次安装模块时，脚本将被执行。

Magento 2有四种类型的脚本：installschema，installdata，upgradeschema和upgradedata。安装脚本只执行一次，而升级脚本每次执行模块版本被更改时执行。

要查看所有四种脚本类型，我们将完成以下问候页任务：

创建 greeting_message 表和列greeting_id 和 message.
添加两个记录： “Happy New Year”, “Happy Holidays”.
接下来，修改表添加另一个字段，“season”，我们添加了记录“Happy Thanksgiving”和“Fall”。
更新第一和第二记录的类型。

我们需要采取的步骤来完成这些任务：

创建新模块.
创建 InstallSchema 脚本.
创建 InstallData 脚本.
添加一个新模块并验证创建数据表。
创建 UpgradeSchema 脚本.
创建 UpgradeData 脚本.
运行升级脚本并验证表已更改。

让我们走过每一步。

1:创建新模块

创建新模块 Learning_GreetingMessage.

进入app/code 文件夹和创建文件夹 Learning 个 Learning/GreetingMessage:

$ cd <magento2_root>/app/code

$ mkdir Learning

$ mkdir Learning/GreetingMessage

现在创建两个文件:

Learning/GreetingMessage/registration.php

/**

* Copyright © 2016 Magento. All rights reserved.

* See COPYING.txt for license details.

*/

\Magento\Framework\Component\ComponentRegistrar::register(

  \Magento\Framework\Component\ComponentRegistrar::MODULE,

  'Learning_GreetingMessage',

  __DIR__

);

Learning/GreetingMessage/etc/module.xml

<?xml version="1.0"?>

<!--

/**

* Copyright © 2016 Magento. All rights reserved.

* * See COPYING.txt for license details.

-->

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd">

  <module name="Learning_GreetingMessage" setup_version="0.0.1">

  </module>

</config>

2: 创建 InstallSchema 脚本

创建一个InstallSchema脚本,在 app/code/Learning/GreetingMessage 文件夹和创建一个Setup 文件夹。

$ cd <magento2_root>/app/code/Learning/GreetingMessage

$ mkdir Setup

创建 Setup/InstallSchema.php文件

/**

* Copyright © 2016 Magento. All rights reserved.

* See COPYING.txt for license details.

*/

namespace Learning\GreetingMessage\Setup;

use Magento\Framework\Setup\InstallSchemaInterface;

use Magento\Framework\Setup\ModuleContextInterface;

use Magento\Framework\Setup\SchemaSetupInterface;

/**

 * @codeCoverageIgnore

 */

class InstallSchema implements InstallSchemaInterface

{

    /**

    * {@inheritdoc}

    * @SuppressWarnings(PHPMD.ExcessiveMethodLength)

    */

    public function install(SchemaSetupInterface $setup, ModuleContextInterface $context)

    {

          /**

          * Create table 'greeting_message'

          */

          $table = $setup->getConnection()

              ->newTable($setup->getTable('greeting_message'))

              ->addColumn(

                  'greeting_id',

                  \Magento\Framework\DB\Ddl\Table::TYPE_INTEGER,

                  null,

                  ['identity' => true, 'unsigned' => true, 'nullable' => false, 'primary' => true],

                  'Greeting ID'

              )

              ->addColumn(

                  'message',

                  \Magento\Framework\DB\Ddl\Table::TYPE_TEXT,

                  255,

                  ['nullable' => false, 'default' => ''],

                    'Message'

              )->setComment("Greeting Message table");

          $setup->getConnection()->createTable($table);

      }

}

让我们花点时间看看代码。

installschema文件都是非常典型的。主代码位于install() 方法,有一个 $setup 参数。这是一个关键参数，因为它提供了访问 Connection() 允许数据库操作的。

连接是 Magento\Framework\DB\Adapter\Pdo\Mysql 一个实例类。

Magento使用DDL（数据定义语言）来操纵数据库。你可以在Magento 2核心代码找到DDL的各种例子。

3:创建 InstallData 脚本

创建 Setup/InstallData.php 文件:

/**

 * Copyright © 2016 Magento. All rights reserved.

 * See COPYING.txt for license details.

 */

namespace Learning\GreetingMessage\Setup;

use Magento\Framework\Setup\InstallDataInterface;

use Magento\Framework\Setup\ModuleContextInterface;

use Magento\Framework\Setup\ModuleDataSetupInterface;

/**

 * @codeCoverageIgnore

 */

class InstallData implements InstallDataInterface

{

    /**

     * {@inheritdoc}

     * @SuppressWarnings(PHPMD.CyclomaticComplexity)

     * @SuppressWarnings(PHPMD.ExcessiveMethodLength)

     * @SuppressWarnings(PHPMD.NPathComplexity)

     */

    public function install(ModuleDataSetupInterface $setup, ModuleContextInterface $context)

    {

          /**

           * Install messages

           */

          $data = [

              ['message' => 'Happy New Year'],

              ['message' => 'Marry Christams']

          ];

          foreach ($data as $bind) {

              $setup->getConnection()

                ->insertForce($setup->getTable('greeting_message'), $bind);

          }

    }

}

4: 添加新模块并验证创建数据表

现在是运行安装脚本并验证带有初始数据的表的时候了，所以我们将运行setup:upgrade 脚本。

$ cd <magento2_root>

$ php bin/magento setup:upgrade

你应该看到一长串包含的模块Learning_GreetingMessage.

现在让我们连接数据库： mysql -u<user> -p<password> <database>

SHOW TABLES LIKE “%greeting%”

+------------------------------------+

| Tables_in_magento_210 (%greeting%) |

+------------------------------------+

| greeting_message                   |

+------------------------------------+

SELECT * FROM greeting_message;

+-------------+-----------------+

| greeting_id | message         |

+-------------+-----------------+

| 1           | Happy New Year  |

| 2           | Happy Holidays  |

+-------------+-----------------+

检查表和数据是否存在

这是怎么工作的？当你创建新模块运行 bin/magento setup:upgrade 脚本,Magento的检查代码，看有没有安装模块。如果它找到任何，它检查是否有任何安装脚本，如果是的话，运行它们。在那之后，Magento更新表格setup_module提出关于模块的版本信息有：

SELECT * FROM setup_module WHERE module='Learning_GreetingMessage';

+--------------------------+----------------+--------------+

| module                   | schema_version | data_version |

+--------------------------+----------------+--------------+

| Learning_GreetingMessage | 0.0.1          | 0.0.1        |

+--------------------------+----------------+--------------+

5: 创建 UpgradeSchema 脚本

要查看升级脚本如何工作，我们将向数据库添加一些数据。

首先，改变版本在 etc/module.xml 文件为0.0.2:

<module name="Learning_GreetingMessage" setup_version="0.0.2">

创建文件 Setup/UpgradeSchema.php:

/**

 * Copyright © 2016 Magento. All rights reserved.

 * See COPYING.txt for license details.

 */

namespace Learning\GreetingMessage\Setup;

use Magento\Framework\Setup\UpgradeSchemaInterface;

use Magento\Framework\Setup\ModuleContextInterface;

use Magento\Framework\Setup\SchemaSetupInterface;

/**

 * Upgrade the Catalog module DB scheme

 */

class UpgradeSchema implements UpgradeSchemaInterface

{

    /**

     * {@inheritdoc}

     */

    public function upgrade(SchemaSetupInterface $setup, ModuleContextInterface $context)

    {

        $setup->startSetup();

        if (version_compare($context->getVersion(), '0.0.2', '<')) {

            $setup->getConnection()->addColumn(

                $setup->getTable('greeting_message'),

                'season',

                [

                    'type' => \Magento\Framework\DB\Ddl\Table::TYPE_TEXT,

                    'length' => 16,

                    'nullable' => false,

                    'default' => '',

                    'comment' => 'Season'

                ]

            );

        }

        $setup->endSetup();

    }

}

注意“version_compare”线。如前所述，该upgradescript将每一次的版本中执行module.xml。因此，我们只希望当前的版本升级脚本执行，而不是以前的升级。这就是为什么我们把升级纳入“如果”条款。

6: 创建 UpgradeData 脚本

创建文件 Setup/UpgradeData.php:

/**

 * Copyright © 2016 Magento. All rights reserved.

 * See COPYING.txt for license details.

 */

namespace Learning\GreetingMessage\Setup;

use Magento\Framework\Setup\UpgradeDataInterface;

use Magento\Framework\Setup\ModuleContextInterface;

use Magento\Framework\Setup\ModuleDataSetupInterface;

/**

 * Upgrade Data script

 */

class UpgradeData implements UpgradeDataInterface

{

    /**

     * {@inheritdoc}

     * @SuppressWarnings(PHPMD.ExcessiveMethodLength)

     */

    public function upgrade(ModuleDataSetupInterface $setup, ModuleContextInterface $context)

    {

        $setup->startSetup();

        if ($context->getVersion()

            && version_compare($context->getVersion(), '0.0.2') < 0

        ) {

            $table = $setup->getTable('greeting_message');

            $setup->getConnection()

                ->insertForce($table, ['message' => 'Happy Thanksgiving, 'season' => 'fall']);

            $setup->getConnection()

                ->update($table, ['season' => 'winter'], 'greeting_id IN (1,2)');

        }

        $setup->endSetup();

    }

}

7: 运行升级脚本并验证表已更改

我们会再次运行setupupgrade脚本：

$ cd <magento2_root>

$ php bin/magento setup:upgrade

现在，我们可以连接到数据库，并验证我们的变化：

select * from greeting_message;

+-------------+--------------------+--------+

| greeting_id | message            | season |

+-------------+--------------------+--------+

| 1           | Happy New Year     | winter |

| 2           | Happy Holidays     | winter |

| 3           | Happy Thanksgiving | fall   |

+-------------+--------------------+--------+