"Mage registry key already exists" when firing events

"Mage registry key already exists" when firing events

July 3, 2026 · Illustrated author avatarBy Stefan Bogdanescu
"Mage registry key already exists" when firing events

Solving the “Mage Registry Key Already Exists” Error When Firing Events

Understanding the Problem

You’re facing an error while trying to hook into the sales_order_save_after event in Magento. The error message states that the Mage registry key already exists:

Mage registry key "_singleton/Modulename/Orderobserver" already exists

This occurs even though your Orderobserver class is named correctly and matches up with the call to the class in the XML configuration file.

Analyzing the Setup

Let’s examine your setup step-by-step to identify the issue:

  1. XML Configuration: Your event observer configuration looks correct:
<sales_order_save_after>
    <observers>
        <modulename>
            <type>singleton</type>
            <class>Modulename/Orderobserver</class>
            <method>generateOrderFile</method>
        </modulename>
    </observers>
</sales_order_save_after>
  1. Class Naming: The class is named correctly according to Magento’s naming conventions: Companyname_Modulename_Model_Modulename_Orderobserver.

  2. File Location: The file is located in the proper path: app/code/local/Companyname/Modulename/Model/Modulename/Orderobserver.php.

Investigating Further

Potential Permissions Issue

The error message from your server logs suggests a permissions issue:

client denied by server configuration:
/var/www/vhosts/path/to/subdomain/httpdocs/app/etc/local.xml

Ensure that the directory and file permissions for your Magento installation are correctly set. The app/code/local folder should have write permissions for the web user to prevent this error.

Incorrect Autoload Configuration

The system log also shows an incorrect autoload configuration:

Failed opening 'Mage/Retailpro/Model/Orderobserver.php' for inclusion

It seems that Magento is trying to autoload your Orderobserver class from a different namespace (Mage/Retailpro/Model/), which doesn’t exist in your module.

Solving the Issue

To resolve this problem, you need to update the autoload configuration for your module.

  1. Update app/etc/modules/Modulename.xml

Open the app/etc/modules/Modulename.xml file and ensure that the <codepool> tag matches the actual code pool of your module:

<config>
    <modules>
        <Companyname_Modulename>
            <active>true</active>
            <codePool>local</codePool>
            <depends/>
        </Companyname_Modulename>
    </modules>
</config>

Make sure codePool is set to local, as your module is located in the app/code/local directory.

  1. Clear Magento Cache

After updating the configuration file, clear the Magento cache:

php -f shell/indexer.php reindexall
rm -rf var/cache/*
  1. Check Class Autoloading

Ensure that the autoload entries for your module are correctly configured in app/code/local/Companyname/Modulename/etc/config.xml:

<global>
    <helpers>
        <modulename>
            <class>Companyname_Modulename_Helper</class>
        </modulename>
    </helpers>
    <models>
        <modulename>
            <class>Companyname_Modulename_Model</class>
        </modulename>
    </models>
</global>

The <class> attributes should point to the correct namespace for your module.

Conclusion

The “Mage registry key already exists” error often occurs due to incorrect autoload configurations or permissions issues. To resolve this:

  1. Verify that the app/etc/modules/Modulename.xml file has the correct code pool (local, in this case).

  2. Ensure that the codePool attribute in the app/etc/modules/Modulename.xml file matches your module’s actual location.

  3. Check and update the autoload entries for your module in app/code/local/Companyname/Modulename/etc/config.xml.

  4. Clear the Magento cache after making changes to the configuration files.

By following these steps, you should be able to hook into events without encountering the “Mage registry key already exists” error.

For more detailed guides on Magento event observer setup and best practices, check out our comprehensive blog posts at https://laravelcompany.com/blog/magento-event-observers.

Security Extensions Configuration Orders

Our network