The Laravel Framework Documentation / Документация к фреймворку Laravel: Quickstart

# Laravel Быстрый старт

likemusic 25.04.14 в 15:04

- [Установка](#installation)

likemusic 25.04.14 в 15:04

- [Маршрутизация](#routing)

likemusic 25.04.14 в 15:05

- [Создание представления](#creating-a-view)

likemusic 25.04.14 в 15:10

- [Создание миграции](#creating-a-migration)

likemusic 25.04.14 в 15:10

- [Eloquent ORM](#eloquent-orm)

likemusic 25.04.14 в 15:10

- [Вывод данных](#displaying-data)

likemusic 25.04.14 в 15:12

<a name="installation"></a>

likemusic 25.04.14 в 15:12

## Установка

likemusic 25.04.14 в 15:12

Фреймворк Laravel использует [Composer](http://getcomposer.org) для установки и управлением зависимостями. Если вы не сделали этого ранее, начните с [установки Composer](http://getcomposer.org/doc/00-intro.md).

likemusic 25.04.14 в 15:14

Теперь вы можете установить Laravel выполнив следующую команду в командной строке:

likemusic 25.04.14 в 15:17

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

likemusic 25.04.14 в 15:18

Эта команда скачает и установит последнюю версию Laravel в новую папку с именем `your-project-name` созданную в текущей директории.

likemusic 25.04.14 в 15:40

Вы также можете самостоятельно скачать копию [репозитория Laravel на Github]. После этого выполните команду `composer install` в созданной Вами папке с проектом. Эта команда скачает и установит необходимые для фреймворка зависимости.

likemusic 25.04.14 в 15:50

Разрешения

likemusic 25.04.14 в 15:50

После установки Laravel, Вам может понадобиться дать веб-серверу разрешение на запись для папки `app/storage`. Смотрите документацию об [установке](/docs/installation) для более подробной информации о настройке.

likemusic 25.04.14 в 16:47

<a name="directories"></a>

likemusic 25.04.14 в 16:50

### Структура папок

likemusic 25.04.14 в 16:50

После установки фреймворка ознакомьтесь с содержимым созданного Вами проекта, для того, чтобы понять структуру папок. Папка `app` содержит папки `views`, `controllers` и `models`. Большая часть кода Ваших приложений будет располагаться в этих папках. Вы также можете ознакомиться с содержимым папки `app/config`, чтобы узнать о доступных настройках.

likemusic 25.04.14 в 17:18

<a name="routing"></a>

likemusic 25.04.14 в 17:19

## Маршрутизация

likemusic 25.04.14 в 17:19

Для начала давайте создадим на первый маршрут. В Laravel простейшим маршрутом является маршрут с функцией-замыканием. Откройте файл `app/routes.php` и добавьте в самом низу следующий код:

likemusic 25.04.14 в 17:28

Route::get('users', function()
{
return 'Users!';
});

likemusic 25.04.14 в 17:30

Теперь, если вы перейдете по адресу `/users` в своем веб-браузере, Вы увидите надпись `Users!`. Здорово! Только что Вы создали свой первый маршрут.

likemusic 25.04.14 в 17:35

Маршрут может быть привязан также к классу контроллера. Например:

likemusic 25.04.14 в 17:36

Route::get('users', 'UserController@getIndex');

likemusic 25.04.14 в 17:36

Этот маршрут информирует фреймворк о том, что на запрос по адресу `/users` должен быть вызван метод `getIndex` класса `UserController`. Для дополнительной информации о контроллерах маршрута смотрите [документацию о контроллерах](/docs/controllers).

likemusic 25.04.14 в 17:40

<a name="creating-a-view"></a>

likemusic 25.04.14 в 17:41

## Создание представления

likemusic 25.04.14 в 17:41

Далее мы создадим простейшее представление для вывода данных о пользователе. Представления располагаются в папке `app/views` и содержат HTML-код вашего приложения. Мы разместим два новых представления в этой папке: `layout.blade.php` and `users.blade.php`. Сперва, давайте создадим файл `layout.blade.php` со следующим содержимым:

likemusic 25.04.14 в 17:44

<html>
<body>
<h1>Laravel Quickstart</h1>
@yield('content')
</body>
</html>

likemusic 25.04.14 в 17:45

Затем создадим представление `users.blade.php`:

likemusic 25.04.14 в 17:45

@extends('layout')
@section('content')
Users!
@stop

likemusic 25.04.14 в 17:45

Часть представленного синтаксиса выгладит немного странно. Это связано с тем, что мы используем шаблонизатор Laravel: Blade. Blade очень быстр благодаря тому что он является просто набором регулярных выражений применяемых к Вашему шаблону для компиляции их в чистый php-код. Blade предоставляет мощную функциональность вроде наследования шаблонов, а также синтаксический сахар для типовых структур управления программой таких как `if` и `for`. Смотрите [документацию Blade](/docs/templates) для дополнительной информации.

likemusic 25.04.14 в 17:54

На данный момент у нас есть наши представления. Давайте вернем их из нашего маршрута `/users`. Вместо возврата из маршрута строки `Users!`, вернем представление:

likemusic 25.04.14 в 17:56

Route::get('users', function()
{
return View::make('users');
});

likemusic 25.04.14 в 17:57

Замечательно! Теперь Вы имеете простое представление, которое расширяет базовый макет. Давайте приступим к работе со слоем базы данных.

likemusic 25.04.14 в 18:00

<a name="creating-a-migration"></a>

likemusic 25.04.14 в 18:00

## Создание миграции

likemusic 25.04.14 в 18:00

Чтобы создать базу данных для хранения наших данных, мы используем систему миграций Laravel. Миграции позволяют однозначно определить изменения в Вашей базе данных, и легко поделиться ими с другими членами Вашей команды.

likemusic 25.04.14 в 18:07

Сперва, давайте настроим соединение с БД. Вы можете настроить все Ваши соединения в файле `app/config/database.php`. По умолчанию Laravel настроен на использование MySQL, и Вам нужно только указать данные учетной записи для подключения к БД в файле с настройками БД. При необходимости, Вы можете установить значение опции `driver` равным `sqlite` после чего будет использоваться БД SQLite расположенная в папке `app/database`.

likemusic 25.04.14 в 18:13

Далее, для создания миграции, мы используем [Artisan CLI](/docs/artisan). Выполните следующую команду в командной строке из корневой папки Вашего проекта:

likemusic 25.04.14 в 18:17

php artisan migrate:make create_users_table

likemusic 25.04.14 в 18:18

Далее, найдите сгенерированный файл миграции в папке `app/database/migrations`. Этот файл содержит класс с двумя методами: `up` и `down`. В методе `up`, Вы должны сделать необходимые изменения в таблицах Вашей БД, а в методе `down` - просто отменить их.

likemusic 25.04.14 в 18:23

Давайте определим миграцию, которая выглядит так:

likemusic 25.04.14 в 18:24

public function up()
{
Schema::create('users', function($table)
{
$table->increments('id');
$table->string('email')->unique();
$table->string('name');
$table->timestamps();
});
}
public function down()
{
Schema::drop('users');
}

likemusic 25.04.14 в 18:24

Теперь мы можем выполнить нашу миграцию из коммандной строки используя команду `migrate`. Просто выполните эту команду в корневой папке Вашего проекта:

likemusic 25.04.14 в 18:26

php artisan migrate

likemusic 25.04.14 в 18:26

Если Вы захотите отменить(откатить) миграцию Вам надо выполнить команду `migrate:rollback`. Теперь, когда у нас есть таблицы в БД, давайте наполним её какими-нибудь данными!

likemusic 25.04.14 в 18:28

<a name="eloquent-orm"></a>

likemusic 25.04.14 в 18:28