Skip to content

Commit

Permalink
update aws versions
Browse files Browse the repository at this point in the history
  • Loading branch information
taylorotwell committed May 29, 2015
1 parent 83b46ee commit 74c4e61
Show file tree
Hide file tree
Showing 3 changed files with 29 additions and 41 deletions.
66 changes: 27 additions & 39 deletions installation.md
Original file line number Diff line number Diff line change
@@ -1,58 +1,53 @@
# Installation

- [Install Composer](#install-composer)
- [Install Laravel](#install-laravel)
- [Server Requirements](#server-requirements)
- [Installation](#installation)
- [Configuration](#configuration)
- [Pretty URLs](#pretty-urls)
- [Pretty URLs](#pretty-urls)

<a name="install-composer"></a>
## Install Composer
<a name="installation"></a>
## Installation

Laravel utilizes [Composer](http:https://getcomposer.org) to manage its dependencies. So, before using Laravel, you will need to make sure you have Composer installed on your machine.
### Server Requirements

The Laravel framework has a few system requirements. Of course, all of these requirements are satisfied by the [Laravel Homestead](/docs/{{version}}/homestead) virtual machine:

<div class="content-list" markdown="1">
- PHP >= 5.5.9
- Mcrypt PHP Extension
- OpenSSL PHP Extension
- Mbstring PHP Extension
- Tokenizer PHP Extension
</div>

<a name="install-laravel"></a>
## Install Laravel
### Installing Laravel

Laravel utilizes [Composer](http:https://getcomposer.org) to manage its dependencies. So, before using Laravel, make sure you have Composer installed on your machine.

### Via Laravel Installer
#### Via Laravel Installer

First, download the Laravel installer using Composer.
First, download the Laravel installer using Composer:

composer global require "laravel/installer=~1.1"

Make sure to place the `~/.composer/vendor/bin` directory in your PATH so the `laravel` executable can be located by your system.

Once installed, the simple `laravel new` command will create a fresh Laravel installation in the directory you specify. For instance, `laravel new blog` would create a directory named `blog` containing a fresh Laravel installation with all dependencies installed. This method of installation is much faster than installing via Composer:
Once installed, the simple `laravel new` command will create a fresh Laravel installation in the directory you specify. For instance, `laravel new blog` will create a directory named `blog` containing a fresh Laravel installation with all of Laravel's dependencies already installed. This method of installation is much faster than installing via Composer:

laravel new blog

### Via Composer Create-Project
#### Via Composer Create-Project

You may also install Laravel by issuing the Composer `create-project` command in your terminal:

composer create-project laravel/laravel --prefer-dist

<a name="server-requirements"></a>
## Server Requirements

The Laravel framework has a few system requirements:

<div class="content-list" markdown="1">
- PHP >= 5.4
- Mcrypt PHP Extension
- OpenSSL PHP Extension
- Mbstring PHP Extension
- Tokenizer PHP Extension
</div>

As of PHP 5.5, some OS distributions may require you to manually install the PHP JSON extension. When using Ubuntu, this can be done via `apt-get install php5-json`.

<a name="configuration"></a>
## Configuration

The first thing you should do after installing Laravel is set your application key to a random string. If you installed Laravel via Composer, this key has probably already been set for you by the `key:generate` command.
After installing Laravel, you may need to configure some permissions. Folders within the `storage` and the `bootstrap/cache` directories should be writable by your web server. If you are using the [Homestead](/docs/{{version}}/homestead) virtual machine, these permissions should already be set.

Typically, this string should be 32 characters long. The key can be set in the `.env` environment file. If you have not renamed the `.env.example` file to `.env`, you may do that now. **If the application key is not set, your user sessions and other encrypted data will not be secure!**
The next thing you should do after installing Laravel is set your application key to a random string. If you installed Laravel via Composer or the Laravel installer, this key has already been set for you by the `key:generate` command. Typically, this string should be 32 characters long. The key can be set in the `.env` environment file. If you have not renamed the `.env.example` file to `.env`, you should do that now. **If the application key is not set, your user sessions and other encrypted data will not be secure!**

Laravel needs almost no other configuration out of the box. You are free to get started developing! However, you may wish to review the `config/app.php` file and its documentation. It contains several options such as `timezone` and `locale` that you may wish to change according to your application.

Expand All @@ -64,17 +59,10 @@ You may also want to configure a few additional components of Laravel, such as:

Once Laravel is installed, you should also [configure your local environment](/docs/{{version}}/configuration#environment-configuration).

> **Note:** You should never have the `app.debug` configuration option set to `true` for a production application.
<a name="permissions"></a>
### Permissions

Laravel may require some permissions to be configured: folders within `storage` and the `bootstrap/cache` directory need to be writable.

<a name="pretty-urls"></a>
## Pretty URLs
### Pretty URLs

### Apache
#### Apache

The framework ships with a `public/.htaccess` file that is used to allow URLs without `index.php`. If you use Apache to serve your Laravel application, be sure to enable the `mod_rewrite` module.

Expand All @@ -87,7 +75,7 @@ If the `.htaccess` file that ships with Laravel does not work with your Apache i
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]

### Nginx
#### Nginx

On Nginx, the following directive in your site configuration will allow "pretty" URLs:

Expand Down
2 changes: 1 addition & 1 deletion mail.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ To use the Mandrill driver, first install Guzzle, then set the `driver` option i

To use the Amazon SES driver, install the Amazon AWS SDK for PHP. You may install this library by adding the following line to your `composer.json` file's `require` section:

"aws/aws-sdk-php": "~2.4"
"aws/aws-sdk-php": "~3.0"

Next, set the `driver` option in your `config/mail.php` configuration file to `ses`. Then, verify that your `config/services.php` configuration file contains the following options:

Expand Down
2 changes: 1 addition & 1 deletion queues.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ In order to use the `database` queue driver, you will need a database table to h

The following dependencies are needed for the listed queue drivers:

- Amazon SQS: `aws/aws-sdk-php ~2.4`
- Amazon SQS: `aws/aws-sdk-php ~3.0`
- Beanstalkd: `pda/pheanstalk ~3.0`
- IronMQ: `iron-io/iron_mq ~2.0`
- Redis: `predis/predis ~1.0`
Expand Down

0 comments on commit 74c4e61

Please sign in to comment.