webapp: A PHP repository from PHP Mentoring

PHP Mentoring App

Requirements

You should have Composer installed and available. If you need to install composer, go to their Getting Started docs. If you will be using Vagrant for local development, you'll need to have it installed as well.

Setup

Using Docker

Clone this repo.
Go into the folder, and run docker-compose up -d to build and run the images
Add the following entry to your hosts file. On unix-like systems, its usually found at /etc/hosts:

127.0.0.1 www.mentoring.dev mentoring.dev
Run chmod +x cb to enable you to run the helper script (Sorry Windows users, but would love help with a PS script)
Run ./cb composer install
Configure Phinx
Run ./cb cli vendor/bin/phinx migrate to run the database migrations.
Copy app/config/parameters.yml.dist to app/config/parameters.yml and configure for your setup
Configure Github
Visit http://localhost:8080 in your browser!

Running Without Vagrant

If you want to help out and cannot download or run Vagrant, you can run the application locally using PHP's built in dev server. You will need the following PHP extensions:

php-curl
php-intl

Steps:

Clone this repo.
Add the following entry to your hosts file. On unix-like systems, its usually found at /etc/hosts:

127.0.0.1 www.mentoring.dev mentoring.dev
Change directory to the directory where you cloned the project in step 1 and run composer install
Copy app/config/parameters.yml.dist to app/config/parameters.yml and configure for your setup
Configure Phinx
Run vendor/bin/phinx migrate to run the database migrations.
Configure Github
To run using PHP's built-in server, navigate to the root of the project and run:

php -S mentoring.dev:8080 -t public public/index.php
Visit http://mentoring.dev:8080 in your browser!

Phinx Configuration

We use Phinx for managing our database migrations. It provides a programmatic way for handling table and data changes. It does require some initial setup however.

From the root project directory, run ./cb cli vendor/bin/phinx init to generate a phinx.yml file.
Edit ./phinx.yml's development section (lines 19-21) with the following values for MySQL.
```
host: mysql
name: appdb
user: dbuser
pass: dbuser
```
To use sqlite, in ./phinx.yml change change the adapter to sqlite (line 17) the name (line 19) to data/mentoring.db.
Edit ./phinx.yml's paths.migrations value (line 2) to:
```
%%PHINX_CONFIG_DIR%%/data/migrations
```

App Configuration

All configuration is store in app/config/parameters.yml. The app ships with a .dist version that you will need to copy/paste into the above path. You can then edit it to your needs.

Github

The application uses Github for authentication. If you are developing or working on features that require a user login, you will need to set up a new Github Application to generate a secret and a key.

Instructions for doing this are available at https://github.com/settings/applications/new.

Set the Homepage and Authorization callback URL to http://mentoring.dev:8080 or http://mentoring.dev, depending on how you set up your hosts file.

Once you have that completed, you will need to add them to the parameters.yml file, like this:

github:
  api_key: 'keyfromgithub'
  api_secret: 'secretfromgithub'

Email in Development

Before you start the Docker containers, you need to change your parameters.yml file. To use mailhog, you'll want the following config:

mail:
  host: 'mailhog'
  port: 1025

You can then view all emails being sent out by the app in your host machine's browser at the following address:

http://localhost:8025

Database Configuration

This app uses the Doctrine DBAL as it's underlying database layer, so you can configure the database using the options in the Silex documentation.

Explicitly, we support MySQL and it's dialect of SQL. Others may work, like SQLite for development environments, but most of the code is written with MySQL in mind.

You can configure the database settings under the database: key.

phpmentoring/webapp