https://github.com/xesk/bamp

BAMP is a small macOS utility to manage your local server based on Apache + MongoDB + PHP using the Homebrew toolkit.
https://github.com/xesk/bamp

apache homebrew macos mongodb php xcode

Last synced: about 1 month ago
JSON representation

BAMP is a small macOS utility to manage your local server based on Apache + MongoDB + PHP using the Homebrew toolkit.

• Host: GitHub
• URL: https://github.com/xesk/bamp
• Owner: xEsk
• License: gpl-3.0
• Created: 2018-02-09T14:10:39.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2023-12-27T17:32:09.000Z (12 months ago)
• Last Synced: 2023-12-28T17:52:46.645Z (12 months ago)
• Topics: apache, homebrew, macos, mongodb, php, xcode
• Language: Objective-C
• Homepage: https://xesk.github.io/BAMP/
• Size: 4.85 MB
• Stars: 10
• Watchers: 2
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: changelog.md
  • License: LICENSE

Awesome Lists containing this project

README

        


  



## What is BAMP?

**BAMP** (**B**rew+**A**pache+**M**ongoDB+**P**HP) is a small macOS utility to manage your local server based on Apache + MongoDB + PHP using the Homebrew toolkit.

The tool assumes that you have installed PHP using Homebrew. 

> Apache and MongoDB are not required to be installed using Homebrew, but I recomend to install them using homebrew.

## Download

It is free and open source. Download the last version [here](https://github.com/xEsk/BAMP/releases).

## Why BAMP if there is MAMP, XAMP, etc...?

I have been using MAMP for years now, but I don't like to wait others to update so I prefere use my own server setup (and I love how homebrew do its job).

## Required tools

You only need to have installed the [Homebrew](https://brew.sh/) in your system (if you are already not using it, don't lose time reading this and install it!).

## Installation

To install MongoDB: ``brew install mongodb``

[Follow those instructions about how to install Apache and multiple PHP versions in your system](https://getgrav.org/blog/macos-sierra-apache-multiple-php-versions). 

Remember to configure your php.ini and maybe some configs in httpd.conf.

If you will control your Apache with BAMP, the **PHP Switcher Script** is not required, BAMP is a PHP Switcher!

## Troubleshootings

I'm sure at 99% that your PHP code will not run on your first try, and your fancy php code ```` section.

Oh! Why **index.php** is not working! You missed to tell Apache to recognise index.php! In **httpd.conf** search **IfModule dir_module** and add index.php.

Example:`` DirectoryIndex index.html index.php``

The mongodb extension on macOS High Sierra is not working! To fix this headache follow [those instructions](https://github.com/Homebrew/homebrew-core/issues/21475#issuecomment-352155715).

## How to use BAMP

Just push the **ON** button and Apache will run up. Push **OFF** and Apach will stop.

You can change at any time the PHP to use in your Apache, simple select one PHP version and tachan!

Also you can configure multiple DocumentsRoot and select one of them at any time.

The server will continue running up, even when BAMP is not running! What does it means? You don't need BAMP keept open to use your server! ;)

## Special considerations

The apache is started up using ``sudo apachectl start``, so if you restart your computer you will need to start Apache again.

The MongoDB server will be started-up automatically, but if an instance of mongod is already running when starting Apache, then BAMP will not manage the start-stop of mongod! 

## Icon credits

The icon is based on [icons8 parrot icon](https://icons8.com/icon/36840/parrot)!