Magento 2 - Correct way of Module Installation

Magento 2 - Correct way of Module Installation

August 3, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento 2 - Correct way of Module Installation

Magento 2 - Correct Way of Module Installation

Magento 2 offers a powerful module system that allows you to extend its functionality through plugins and modules. In this post, we’ll walk through the correct way to install a Magento 2 module using the example provided.

Understanding the Module Structure

The first step in installing a Magento 2 module is understanding its structure. The module’s root directory should follow this format:

app/code/NameSpace/Module/

In your case, you have Magentostudy_News as the module name, so the directory structure would be:

app/code/Magentostudy/News/

Configuring the Module XML File

The module.xml file defines basic information about the module. Here’s an example of a properly configured module.xml:

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../../../../lib/internal/Magento/Framework/Module/etc/module.xsd">
    <module name="Magentostudy_News" setup_version="0.0.1" schema_version="0.0.1"/>
</config>

This file specifies the module’s name, setup version, and schema version.

Configuring the Composer File

The composer.json file manages dependencies for your module. Here’s a properly configured example:

{
    "name": "magentostudy/module-news",
    "description": "N/A",
    "require": {
        "php": "~5.5.0|~5.6.0|~7.0.0",
        "magento/module-store": "100.0.0",
        "magento/module-email": "100.0.0",
        "magento/module-ui": "100.0.0",
        "magento/framework": "100.0.0"
    },
    "type": "magento2-module",
    "version": "0.0.1",
    "license": [
        "OSL-3.0",
        "AFL-3.0"
    ],
    "autoload": {
        "files": [ "registration.php" ],
        "psr-4": {
            "Magentostudy\\News\\": ""
        }
    }
}

This file ensures that the module depends on the required Magento core modules and specifies the autoloading mechanism.

Configuring the Registration File

The registration.php file registers your module with Magento’s system. The content should look like this:

<?php
\Magento\Framework\Component\ComponentRegistrar::register(
    \Magento\Framework\Component\ComponentRegistrar::MODULE,
    'Magentostudy_News',
    __DIR__
);

This line of code tells Magento that the Magentostudy_News module is located in the current directory (__DIR__).

Enabling the Module

To enable your newly installed module, navigate to your terminal and execute this command:

php ./bin/magento module:enable Magentostudy_News

This command enables the Magentostudy_News module. If you get an error about commands not being defined in the “module” namespace, ensure you have the Magento CLI installed properly.

The Role of Database Schema Setup

Your module requires a schema setup to create necessary database tables. You’ve already created the Setup/InstallSchema.php file, which is correct for this purpose.

The Setup folder and the InstallSchema.php file within it are responsible for creating the magentostudy_news table in your database during Magento’s installation process or upgrade.

Conclusion

Installing a Magento 2 module involves several key steps:

  1. Ensure the module directory structure matches the expected format.
  2. Configure the module.xml file with correct metadata.
  3. Set up the composer.json to manage dependencies correctly.
  4. Create the registration.php file for component registration.
  5. Enable the module via the Magento CLI command.
  6. Ensure database schema setup files (like InstallSchema.php) are properly configured.

By following these steps, you can install modules in Magento 2 effectively and extend its functionality as needed. For more detailed guides on Magento development, visit Laravel Company.

Magento 2 Extensions Configuration Deployment

Our network