PHPackages                             elgentos/module-baseurlpath - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. elgentos/module-baseurlpath

ActiveMagento2-module[Utility & Helpers](/categories/utility)

elgentos/module-baseurlpath
===========================

Allow Magento config to have a base url path instead of root without moving Magento 2 into a subdirectory

1.0.1(5y ago)104.9k2GPL-3.0PHP

Since Oct 1Pushed 5y ago2 watchersCompare

[ Source](https://github.com/elgentos/magento2-baseurlpath)[ Packagist](https://packagist.org/packages/elgentos/module-baseurlpath)[ RSS](/packages/elgentos-module-baseurlpath/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (2)Dependencies (3)Versions (3)Used By (0)

[![Build Status](https://camo.githubusercontent.com/db639ceaa6782e8378ca57653b4826ff365908469d0f94a7989e8292ad55cecc/68747470733a2f2f7472617669732d63692e6f72672f656c67656e746f732f6d6167656e746f322d6261736575726c706174682e7376673f6272616e63683d6d61696e)](https://travis-ci.org/elgentos/magento2-baseurlpath)

Magento 2 - Elgentos\_BaseUrlPath
=================================

[](#magento-2---elgentos_baseurlpath)

Allow setting up a base url in system config other than root.

If you want to add `https://my.domain.tld/mypseronalurl/` after the baseurl Magento currently doesn't allow this. You are left with adding the storecode to the path or creating subdirectories with extra files.

This can get ugly if you just want to add language codes(other than locale-codes) to your domain, for example `https://my.domain.tld/en/` and `https://my.domain.tld/nl/`

Installation: part 1 - Module via composer
------------------------------------------

[](#installation-part-1---module-via-composer)

Install the module via composer by running

```
composer require elgentos/module-baseurlpath

bin/magento module:enable Elgentos_BaseUrlPath
bin/magento cache:flush
```

Installation: part 2 - Nginx MAGE\_RUN\_CODE
--------------------------------------------

[](#installation-part-2---nginx-mage_run_code)

Make sure you setup your `MAGE_RUN_CODE` mapping correctly. By default in Nginx this is only done based on **$host** name.

We will add the **$request\_uri** to the mapping.

```
# https://{host}/{language}/{magento_request}/
# Most specific match goes first
map $host$request_uri $mageRunCode {
  hostnames;
  default default;
  ~other.domain.tld/nl/ other_nl;
  ~other.domain.tld other_en;
  ~my.domain.tld/en/ site_en;
  ~my.domain.tld site_nl;
}

# fastcgi section
fastcgi_param MAGE_RUN_CODE $mageRunCode;
```

### Nginx without mapping

[](#nginx-without-mapping)

Or if Nginx mapping isn't available for you.

```
# https://{host}/{language}/{magento_request}/
# Most specific match goes last
# this one is untested thought(sorry for that)

set $mageRunCode "default";
if ($host$request_uri ~ other.domain.tld/) {
    set $mageRunCode "other_en";
}
if ($host$request_uri ~ other.domain.tld/nl/) {
    set $mageRunCode "other_nl";
}
if ($host$request_uri ~ my.domain.tld/) {
    set $mageRunCode "site_nl";
}
if ($host$request_uri ~ my.domain.tld/en/) {
    set $mageRunCode "site_en";
}
```

Configuration
-------------

[](#configuration)

After installation goto `Stores` / `Configuration` -> `General` / `Web` -> `Base URLs ((Un)Secure)`

**My strong advise setting these settings on website or store view level because making errors could potentially lock you out from the admin pages**

Store 1: site\_en
-----------------

[](#store-1-site_en)

Update your base url to `https://my.domain.tld/en/`[![example baseurl setting english store](example-baseurl-en.png)](example-baseurl-en.png)

Store 2: site\_nl
-----------------

[](#store-2-site_nl)

Update your base url to `https://my.domain.tld/nl/`[![example baseurl setting dutch store](example-baseurl-nl.png)](example-baseurl-nl.png)

Static content and media
------------------------

[](#static-content-and-media)

To make static content work with these settings, you explicitly need to setup these paths to the root(`/`) of your site.

[![example baseurl setting static media parameters](example-baseurl-static-media.png)](example-baseurl-static-media.png)

Authors
-------

[](#authors)

- [Jeroen Boersma](https://github.com/jeroenboersma)
- [Wouter Steenmeijer](https://github.com/woutersteen)
- [Peter Jaap Blaakmeer](https://github.com/peterjaap)

###  Health Score

31

—

LowBetter than 66% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity25

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

2

Last Release

2100d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/88a6d8dc588e8f2a0948335563a754687f71304f0bd3b7f7049d4bcdc00a563c?d=identicon)[peterjaap](/maintainers/peterjaap)

---

Top Contributors

[![JeroenBoersma](https://avatars.githubusercontent.com/u/1163348?v=4)](https://github.com/JeroenBoersma "JeroenBoersma (15 commits)")

---

Tags

magento2magento2-module

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/elgentos-module-baseurlpath/health.svg)

```
[![Health](https://phpackages.com/badges/elgentos-module-baseurlpath/health.svg)](https://phpackages.com/packages/elgentos-module-baseurlpath)
```

###  Alternatives

[fastly/magento2

Fastly CDN Module for Magento 2.4.x

1564.4M1](/packages/fastly-magento2)[loki/magento2-components

Core module for defining Alpine.js components with advanced AJAX features

1011.8k26](/packages/loki-magento2-components)[fishpig/magento2-wordpress-integration

Securely integrate WordPress and Magento 2.

83369.2k7](/packages/fishpig-magento2-wordpress-integration)[run-as-root/magento2-prometheus-exporter

Magento2 Prometheus Exporter

68357.9k](/packages/run-as-root-magento2-prometheus-exporter)[zwernemann/module-withdrawal

Magento 2 EU Withdrawal Button Module - Adds a withdrawal/revocation button for orders in compliance with EU Directive (EU) 2023/2673

244.9k2](/packages/zwernemann-module-withdrawal)[myparcelnl/magento

A Magento 2 module that creates MyParcel labels

1860.2k](/packages/myparcelnl-magento)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)