How to get a url parameter in Magento controller?

How to get a url parameter in Magento controller?

August 5, 2026 · Illustrated author avatarBy Stefan Bogdanescu
How to get a url parameter in Magento controller?

Getting URL Parameters in Magento Controller

As a senior developer working extensively with e-commerce platforms like Magento, I often need to extract parameters from URLs within controller methods. In this post, we’ll explore how to retrieve the “id” parameter from a URL like http://example.com/path/action/id/123.

Understanding Magento’s URL Structure

Magento uses a custom URL structure where parameters are appended after the resource path and route name. The format is typically: <base_url>/<path>/<action>/<optional_parameters>

For example, in your case:

  • <base_url>: http://example.com
  • <path>: path
  • <action>: action
  • <optional_parameters>: id/123

Retrieving URL Parameters

Magento provides several ways to retrieve parameters from the URL. Let’s explore two common methods.

Method 1: Using $this->getRequest()->getParams()

The most straightforward way is to use the $_REQUEST superglobal array and filter it using the getParams() method of the request object in your controller:

public function execute()
{
    $request = $this->getRequest();
    $params = $request->getParams();

    $id = $params['id'];
    // Continue with your logic...
}

This works fine, but it requires manual filtering to ensure you’re working with the expected data.

Method 2: Using Magento’s Core Controller Methods

Magento’s core controllers use a more structured approach. They define their parameters as protected properties and then access them directly in methods like execute().

Here’s an example of how this is done:

class MyController extends Mage_Core_Controller_Front_Action
{
    public function execute()
    {
        $id = $this->getRequest()->getParam('id');
        // Continue with your logic...
    }
}

The getParam() method retrieves the value of the specified parameter from the request. It automatically filters and sanitizes input based on Magento’s configuration.

Why Your Attempt Failed

You mentioned that $this->getRequest()->getParam('id') didn’t work as expected. This is likely due to how you’re setting up your route.

If your URL looks like http://example.com/path/action?id=123, then the parameter should be retrieved with $this->getRequest()->getQuery('id'). The query parameters are stored separately from the path and action parameters in Magento’s request object.

Best Practices

When working with URLs in Magento, I recommend following these best practices:

  1. Always use the Mage_Core_Controller_Front_Action base class for your controllers to inherit the core functionality.
  2. Define protected properties for any required parameters and use them in your methods.
  3. Sanitize and validate input data to prevent security vulnerabilities like SQL injection or cross-site scripting (XSS).
  4. Consider using Magento’s built-in URL helper functions ($this->getUrl()) when generating URLs to ensure they match the platform’s conventions.

Conclusion

Retrieving parameters from a URL in a Magento controller is straightforward once you understand how the platform handles routing and requests. By leveraging the Mage_Core_Controller_Front_Action base class and using the appropriate request methods, you can efficiently extract the necessary data for your business logic.

Remember to always validate and sanitize input data to maintain the security and stability of your Magento application.

For more advanced topics on Magento development, I recommend checking out our comprehensive guides at Laravel Company.

Magento

Our network