How should I include an external php file in magento module?

How should I include an external php file in magento module?

July 15, 2026 · Illustrated author avatarBy Stefan Bogdanescu
How should I include an external php file in magento module?

Including External PHP Files in Magento Modules

When developing custom Magento modules, you may need to integrate third-party libraries or external PHP files into your codebase. This guide will walk you through the process of including an external file containing the classes ThirdPartyClassA and ThirdPartyClassB, located in thirdPartyCode.php.

Understanding the Directory Structure

First, let’s clarify where to place the thirdPartyCode.php file within your module directory structure. A typical Magento 2 module follows this layout:

<your_module>
│
├─ etc/
│   └─ module.xml
│
├─ registration.php
│
└─ src/
    ├─ Model/
    │   └─ ThirdPartyClassA.php
    ├─ Controller/
    │   └─ Index.php  // Example Action Handler
    └─ thirdPartyCode.php  // Place the external file here

In this example, we recommend placing the thirdPartyCode.php file directly in the root of your module’s src directory. This keeps third-party dependencies organized and separate from core Magento files.

Referring to the External File

Now let’s discuss how to properly refer to (require_once) the external file within one of your Action handlers, such as a controller.

The best practice is to create a separate service or helper class that acts as an intermediary between your module’s controllers and the third-party code. This promotes decoupling and makes your code more maintainable.

Create a new file src/Model/ThirdPartyCodeService.php:

<?php

namespace YourModule\Model;

class ThirdPartyCodeService
{
    public function __construct()
    {
        // Ensure the third party classes are autoloaded
        require_once dirname(__DIR__) . '/thirdPartyCode.php';
    }

    public function useThirdPartyClassA(): ThirdPartyClassA
    {
        return new ThirdPartyClassA();
    }
}

In this ThirdPartyCodeService class, we’re using a constructor to ensure that the thirdPartyCode.php file is required when an instance of this service is created. This approach guarantees that your third-party classes are autoloaded and available for use within any method of this service.

Using the Service in Your Controller

Next, update your controller to inject the ThirdPartyCodeService:

<?php

namespace YourModule\Controller\Index;

use Magento\Framework\App\Action\Context;
use YourModule\Model\ThirdPartyCodeService;

class Index extends \Magento\Framework\App\Action\Action
{
    private $thirdPartyCodeService;

    public function __construct(Context $context, ThirdPartyCodeService $thirdPartyCodeService)
    {
        parent::__construct($context);
        $this->thirdPartyCodeService = $thirdPartyCodeService;
    }

    public function execute()
    {
        $thirdPartyClassAInstance = $this->thirdPartyCodeService->useThirdPartyClassA();

        // Now you can use the instance of ThirdPartyClassA within your execute() method
        $result = $thirdPartyClassAInstance->performSomeAction();
        echo $result;
    }
}

In this example, we’re injecting an instance of ThirdPartyCodeService into our controller’s constructor. This allows us to call methods like useThirdPartyClassA() directly within the execute() method.

Conclusion

When working with external PHP files in Magento modules, it’s crucial to follow best practices for organization and dependency management. Placing the file in the appropriate directory is a key first step.

However, rather than requiring the file directly within your controllers, we’ve demonstrated a more elegant approach using a service class as an intermediary. This approach promotes decoupling, maintainability, and keeps your code clean and organized.

Remember that proper autoloading guarantees your third-party classes are available when needed, and injecting services into controllers is a standard Magento practice.

To learn more about Magento 2 module development best practices, be sure to check out Laravel Company’s comprehensive guide on Magento 2 development.

Magento 2 Extensions Themes

Our network