PHPackages                             colinmollenhour/modman - 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. colinmollenhour/modman

ActiveLibrary[Utility & Helpers](/categories/utility)

colinmollenhour/modman
======================

Module Manager

1.14(5y ago)72176.3k↓41.7%172[15 issues](https://github.com/colinmollenhour/modman/issues)[2 PRs](https://github.com/colinmollenhour/modman/pulls)3Apache-2.0Shell

Since May 3Pushed 5y ago67 watchersCompare

[ Source](https://github.com/colinmollenhour/modman)[ Packagist](https://packagist.org/packages/colinmollenhour/modman)[ Docs](https://github.com/colinmollenhour/modman)[ RSS](/packages/colinmollenhour-modman/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)DependenciesVersions (12)Used By (3)

modman (Module Manager)
=======================

[](#modman-module-manager)

Developing extensions for software that doesn't allow you to separate your files from core files, and keeping that extension under version control and making it easy to deploy is now much, much easier. Development of this script was inspired by Magento which forces you to mix your extension files all throughout the core code directories. With modman, you can specify in a text file where you want your directories and files to be mapped to, and it will maintain symlinks for you so that your code is easy to hack and deploy.

All of your cloned/checked-out modules will be kept in a directory named `.modman` in the location where you run `modman init`.

Requirements
------------

[](#requirements)

- Linux/Unix or OSX (not cygwin, see *Windows Users* below)
- bash
- Common utilities available in your PATH: grep (POSIX), find, ln, cp, basename, dirname
- Web server must follow symlinks
- git and/or subversion are optional (not required for "deploy" command)

### Magento Users

[](#magento-users)

If using template files in a modman module, you must either:

#### Option 1:

[](#option-1)

Use a [patched](https://gist.github.com/colinmollenhour/35c0d32dd651c4c8c840/revisions) version of Mage/Core/Block/Template.php. This gist is itself a modman module so you can install it by cloning it directly or you can integrate it into your environment some other way.

```
$ modman clone template-patch https://gist.github.com/35c0d32dd651c4c8c840.git

```

*NOTE:* I provide no warranties for using this patch. Use at your own risk!

#### Option 2:

[](#option-2)

Enable "Allow Symlinks" (found under System > Configuration > Advanced > Developer).

[![Allow Symlinks](https://camo.githubusercontent.com/6c783ff43df5baaba0e8028606c50a7961f4d600cc72927f90e94f78f1a26d2e/68747470733a2f2f662e636c6f75642e6769746875622e636f6d2f6173736574732f313333373436312f34333332342f38323064346439362d353637662d313165322d393437612d3136376266373664623333662e706e67)](https://camo.githubusercontent.com/6c783ff43df5baaba0e8028606c50a7961f4d600cc72927f90e94f78f1a26d2e/68747470733a2f2f662e636c6f75642e6769746875622e636f6d2f6173736574732f313333373436312f34333332342f38323064346439362d353637662d313165322d393437612d3136376266373664623333662e706e67)

*NOTE:* Disabling this security protection does decrease security as it allows template files to be loaded from any location. However, the risk is not so much symlinks as it is specially crafted template paths. The patched Template.php file (Option 1) allows the use of symlinks but should still prevent templates from being loaded from directories other than the app/design directory.

### Windows Users

[](#windows-users)

Windows (including cygwin) is not supported by this script, but there is a [PHP-port of modman](https://github.com/sitewards/modman-php) which works on Windows. I am not affiliated with the authors and do not provide support for the PHP port, only a link here for reference.

Installation
------------

[](#installation)

To install Modman, you can either install the library in your user's root folder, or you can install Modman globally. Regardless of which option you choose, first run one of these two scripts to download the Modman repo.

```
bash <