Class 'Magento\Framework\App\Action\Action' not found

Class 'Magento\Framework\App\Action\Action' not found

September 28, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Class 'Magento\Framework\App\Action\Action' not found

[Blog Post]

Resolving ‘Class Magento\Framework\App\Action\Action not found’ Error in Magento 2

As a senior developer working with Magento 2, I frequently encounter various errors during module development and debugging. One of the most common issues faced by developers is the dreaded “Class Magento\Framework\App\Action\Action not found” error.

Understanding the Error

This error typically occurs when trying to extend the Magento\Framework\App\Action\Action class within a custom controller file in your third-party module. The error message indicates that PHP cannot find the mentioned class, even though it exists in the Magento framework.

Analyzing the Given Scenario

The user provided relevant information about their setup and the error they encountered:

  • Environment: MAMP with PHP 7.0.33
  • Magento Version: v2.2.2
  • Module: A third-party tracking numbers module
  • Error Location: magento/app/code/Orderinfo/Details/Controller/Index/index.php
  • Compiler Check: The command setup:di:compile runs without any issues

Identifying the Root Cause

After carefully reviewing the error log and the provided code snippet, the root cause seems to be a permissions issue or a missing autoload configuration.

Step-by-Step Resolution Approach

1. Verify Permissions

Ensure that your Magento installation has proper file permissions set up:

  • The magento directory should have permissions of 755.
  • All files within the magento/lib/internal/Magento, magento/vendor/magento, and magento/app/code/Magento directories should have permissions of 644.

You can use the following commands to set the correct permissions:

chmod 755 -R magento
find magento -type f -exec chmod 644 {} \;

2. Check Autoload Configuration

Magento uses composer autoloading for managing dependencies and classes. Ensure that your Magento installation is properly configured with the composer.json and composer.lock files in the project root directory.

If the autoload configuration is missing or corrupted, you can run:

composer install --no-dev --optimize-autoloader

This command will reinstall all packages and optimize the autoload configurations for your Magento installation.

3. Verify the Controller Structure

Double-check that your custom controller file follows the correct structure and naming conventions:

  • The file name should match the controller class name (e.g., index.php corresponds to the Index class).
  • The namespace declaration at the beginning of the file must be accurate.
  • Ensure that you are extending the correct parent class (Magento\Framework\App\Action\Action).

4. Clear Cache and Recompile

To ensure that Magento’s cache is cleared and all required files are compiled, run the following commands:

php bin/magento cache:clean
php bin/magento setup:di:compile

Conclusion

Resolving the “Class Magento\Framework\App\Action\Action not found” error often requires a combination of verifying file permissions, checking autoload configurations, and ensuring the correct controller structure.

By following the steps outlined in this post, you should be able to identify and resolve this issue in your development environment. If you still encounter difficulties, double-check that your Magento installation is configured correctly and consider reaching out to the community or seeking professional assistance for further guidance.

Remember to always keep your Magento version up-to-date and use a stable PHP version compatible with your specific installation.

For more detailed information on Magento 2 module development and debugging, I recommend exploring Laravel Company’s comprehensive guides.

Magento 2 Security Extensions Configuration

Our network