Установка¶

Установка Composer¶

CakePHP использует мендежер зависимостей PHP Composer, как официально поддерживаемый метод установки.

• Установка Composer на Linux и macOS

  1. Запустите скрипт установки, как описано в официальной документации Composer и следуйте инструкциям по установке, чтобы установить Composer.

  2. Выполните следующую команду, чтобы переместить composer.phar в директорию по адресу:

     mv composer.phar /usr/local/bin/composer
     

• Установка Composer на Windows

  Для установки Composer на Windows, вы можете скачать установщик Composer для Windows здесь. Более подробные инструкции по установке Composer на Windows можно найти в README здесь.

Создание проекта CakePHP¶

Теперь, когда вы скачали и установили Composer, предположим вы хотите создать новое приложение CakePHP в папке my_app_name. Для этого просто выполните следующую команду composer:

php composer.phar create-project --prefer-dist cakephp/app:^3.8 my_app_name

Или если Composer установлен глобально:

composer self-update && composer create-project --prefer-dist cakephp/app:^3.8 my_app_name

Как только Composer закончит скачивание каркаса приложения и библиотеки ядра CakePHP, у вас должно появиться полностью работоспособное приложение CakePHP. Убедитесь в том, чтобы в папке вашего приложения всегда были файлы composer.json и composer.lock.

Вы можете перейти по тому пути, куда установлено ваше приложение CakePHP и вы увидите стандартную домашнюю страницу. Чтобы изменить ее содержимое, вы можете отредактировать файл src/Template/Pages/home.ctp.

Несмотря на то, что composer является рекомендуемым методом установки, имеются также готовые сборки доступные для скачивания на Github. Эти сборки содержат каркас приложения со всеми установленными пакетами. Также они содержат файл composer.phar, таким образом вы получаете все необходимое для дальнейшей работы.

Обновление CakePHP до актуальной версии¶

По умолчанию в файле composer.json вашего приложения присутствуют следующие настройки:

"require": {
    "cakephp/cakephp": "3.4.*"
}

Каждый раз при запуске команды php composer.phar update вы будете получать патчи для данной минорной версии. Вы все же можете изменить это значение на ~3.4 для получения последней стабильной версии ветки 3.x.

Если вы хотите получать позднейшие изменения в CakePHP, еще не вошедшие в релиз, установите значение версии dev-master в файле composer.json:

"require": {
    "cakephp/cakephp": "dev-master"
}

Учтите, что устанавливать данное значение не рекомендуется, так как это может нарушить работоспособность вашего приложения при установке следующей релизной версии. В дополнение к этому composer не кеширует промежуточные ветки разработки, и это может привести к замедлению последующих обновлений через composer.

Установка с помощью Oven¶

Еще один быстрый способ установки CakePHP это Oven. Это простой PHP-скрипт, который определяет, что требуется скачать, уcтанавливает каркас приложения CakePHP и выполняет все необходимые предварительные настройки.

После завершения установки вы также получите работоспособное приложение CakePHP.

Apache¶

Хотя CakePHP создан для работы с mod_rewrite «из коробки» - и обычно это так и есть - мы заметили, что некоторые пользователи пытаются получить все для хорошей работы в их системах.

Вот несколько вещей, которые вы можете попробовать сделать, чтобы он работал правильно. Первый взгляд на ваш httpd.conf. (Убедитесь, что вы редактируете системный httpd.conf,а не пользовательский или определенный на сайте httpd.conf.)

Эти файлы могут различаться в разных дистрибутивах и версиях Apache. Вы Может также посмотреть https://wiki.apache.org/httpd/DistrosDefaultLayout для более подробной информации.

1. Убедитесь, что переопределение .htaccess разрешено и, что AllowOverride установлен в значении All для корректного DocumentRoot. Вы должны наблюдать нечто похожее на:

   # Каждая папка, к которой Apache имеет доступ, может быть настроена
   # в отношении того, какие сервисы и возможности разрешены и/или запрещены в той
   # папке (и ее подпапках).
   #
   # Для начала, мы настроим параметры "по умолчанию" довольно ограниченными
   # возможностями.
   <Directory />
       Options FollowSymLinks
       AllowOverride All
   #    Order deny,allow
   #    Deny from all
   </Directory>
   

2. Убедитесь, что вы загружаете mod_rewrite корректно. Вы должны видеть нечто подобное:

   LoadModule rewrite_module libexec/apache2/mod_rewrite.so
   

   Во многих системах эти настройки по умолчанию закомментированы, так что вы просто должны их раскомментировать, удалив символы # перед строками.

   После внесения правок перезапустите Apache, чтобы настройки вступили в силу.

   Убедитесь, что ваши файлы .htaccess находятся в правильных папках. Некоторые операционные системы скрывают файлы, имена которых начинаются с „.“ и таким образом не позволяют копировать их.

3. Убедитесь, что ваша копия CakePHP получена из нашего Git-репозитория, и корректно распакована, проврив файлы .htaccess.

   Папка app CakePHP (будет скопирована в корневую папку вашего приложения консолью bake):

   <IfModule mod_rewrite.c>
       RewriteEngine on
       RewriteRule    ^$    webroot/    [L]
       RewriteRule    (.*) webroot/$1    [L]
   </IfModule>
   

   Папка webroot CakePHP (будет скопирована в корневую папку вашего приложения консолью bake):

   <IfModule mod_rewrite.c>
       RewriteEngine On
       RewriteCond %{REQUEST_FILENAME} !-f
       RewriteRule ^ index.php [L]
   </IfModule>
   

   Если у вашего сайта CakePHP все еще есть проблемы с mod_rewrite, попробуйте изменить настройки Virtual Hosts. На Ubuntu, отредактируйте файл /etc/apache2/доступные-сайты/default (расположение зависит от дистрибутива). В этом файле убедиесь, что опция AllowOverride None изменена на AllowOverride All:

   <Directory />
       Options FollowSymLinks
       AllowOverride All
   </Directory>
   <Directory /var/www>
       Options Indexes FollowSymLinks MultiViews
       AllowOverride All
       Order Allow,Deny
       Allow from all
   </Directory>
   

   На macOS, другое решение - это использовать инструмент virtualhostx, чтобы заставить Virtual Host ссылаться на вашу папку.

   Для многих хостингов (GoDaddy, 1and1) ваш веб-сервер изначально обслуживается из папки пользователя, которая изначально использует mod_rewrite. Если вы устанавливаете CakePHP в папку пользователя (http://example.com/~username/cakephp/), или любой другой URL, уже использующий mod_rewrite, вам понадобится добавить блоки RewriteBase в файлы .htaccess, используемые CakePHP (.htaccess, webroot/.htaccess).

   Это может быть добавлено в ту же секцию, что и директива RewriteEngine. Так, к примеру ваш файл .htaccess папки webroot может выглядеть так:

   <IfModule mod_rewrite.c>
       RewriteEngine On
       RewriteBase /путь/к/app
       RewriteCond %{REQUEST_FILENAME} !-f
       RewriteRule ^ index.php [L]
   </IfModule>
   

   Более детальный разбор необходимых изменений будет зависеть от вашей конкретной установки, и может потребоваться указание параметров, не связанных непосредственно с CakePHP. Для более подробной информации пожалуйста ознакомьтесь с онлайн-документацией Apache.

4. (Опционально) Чтобы улучшить настройки продакшена, вы должны предотвращать обработку фреймворком CakePHP несуществующих ресурсов. Измените файл .htaccess папки webroot например вот так:

   <IfModule mod_rewrite.c>
       RewriteEngine On
       RewriteBase /путь/к/app/
       RewriteCond %{REQUEST_FILENAME} !-f
       RewriteCond %{REQUEST_URI} !^/(webroot/)?(img|css|js)/(.*)$
       RewriteRule ^ index.php [L]
   </IfModule>
   

   Данные настройки предотвратят передачу некорректных параметров файлу index.php и в случае необходимости вернут 404 ошибку.

   В дополнение к этому вы можете создать шаблон страницы для 404 ошибки, или же можете использовать встроенный в CakePHP шаблон, добавив директиву ErrorDocument:

   ErrorDocument 404 /404-not-found
   

nginx¶

nginx не использует файлы .htaccess как Apache, так что необходимо создавать эти переопределенные URL в конфигурации сайта. Обычно все это находится в /etc/nginx/доступные-сайты/файл_конфигурации_вашего_виртуального_хоста. В зависимости от ваших настроек, вам возможно придется внести некоторые правки в данные параметры, но как правило небольшие, вам понадобится PHP на FastCGI:

server {
    listen   80;
    server_name www.example.com;
    rewrite ^(.*) http://example.com$1 permanent;
}

server {
    listen   80;
    server_name example.com;

    # директива root должна быть глобальной
    root   /var/www/example.com/public/webroot/;
    index  index.php;

    access_log /var/www/example.com/log/access.log;
    error_log /var/www/example.com/log/error.log;

    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
        try_files $uri =404;
        include /etc/nginx/fastcgi_params;
        fastcgi_pass    127.0.0.1:9000;
        fastcgi_index   index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

На некоторых серверах (таких как Ubuntu 14.04) приведенная выше конфигурация не будет работать «из коробки», и документация nginx рекомендует иной подход (https://nginx.org/en/docs/http/converting_rewrite_rules.html). Попробуйте нижеприведенные настройки (вы можете заметить, что в данном случае используется всего один блок server {}, а не два, как бы там ни было, если вы хотите иметь доступ к вашему приложению CakePHP еще и с адреса example.com помимо www.example.com, ознакомьтесь с документацией по ссылке выше):

server {
    listen   80;
    server_name www.example.com;
    rewrite 301 http://www.example.com$request_uri permanent;

    # директива root должна быть глобальной
    root   /var/www/example.com/public/webroot/;
    index  index.php;

    access_log /var/www/example.com/log/access.log;
    error_log /var/www/example.com/log/error.log;

    location / {
        try_files $uri /index.php?$args;
    }

    location ~ \.php$ {
        try_files $uri =404;
        include /etc/nginx/fastcgi_params;
        fastcgi_pass    127.0.0.1:9000;
        fastcgi_index   index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

IIS7 (Windows хостинги)¶

IIS7 изначально не поддерживает файлы .htaccess. В то время, когда существуют дополнения, добавляющие эту поддержку, вы можете также импортировать правила htaccess в IIS для использования встроенных в CakePHP переопределений. Чтобы сделать это, выполните следующие шаги:

1. Используйте Microsoft Web Platform Installer для установки URL Rewrite Module 2.0 или скачайте его (32-bit / 64-bit).

2. Создайте новый файл web.config в вашей корневой папке CakePHP.

3. Используя Блокнот или любой XML-safe редактор, скопируйте следующий код в ваш новый файл web.config:

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <rewrite>
            <rules>
                <rule name="Exclude direct access to webroot/*"
                  stopProcessing="true">
                    <match url="^webroot/(.*)$" ignoreCase="false" />
                    <action type="None" />
                </rule>
                <rule name="Rewrite routed access to assets(img, css, files, js, favicon)"
                  stopProcessing="true">
                    <match url="^(img|css|files|js|favicon.ico)(.*)$" />
                    <action type="Rewrite" url="webroot/{R:1}{R:2}"
                      appendQueryString="false" />
                </rule>
                <rule name="Rewrite requested file/folder to index.php"
                  stopProcessing="true">
                    <match url="^(.*)$" ignoreCase="false" />
                    <action type="Rewrite" url="index.php"
                      appendQueryString="true" />
                </rule>
            </rules>
        </rewrite>
    </system.webServer>
</configuration>

Как только файл web.config будет создан с корректными правилами переопределения, все ссылки на CSS-стили, JavaScript и перенаправление маршрутов CakePHP должны работать корректно.

Я не могу использовать переопределение URL¶

Если вы не хотите или не можете активировать модуль mod_rewrite (или модуль совместимый с ним) на вашем сервере, вы можете использовать встроенные возможности CakePHP. В файле config/app.php раскомментируйте строку:

'App' => [
    // ...
    // 'baseUrl' => env('SCRIPT_NAME'),
]

И удалите эти файлы .htaccess:

/.htaccess
webroot/.htaccess

Это заставит ваши URL выглядеть как www.example.com/index.php/controllername/actionname/param вместо www.example.com/controllername/actionname/param.