Установка Composer

• Запуск приложения
• Добавление CodeIgniter4 в существующий проект
• Установка переводов

Composer может быть использован несколькими способами для установки CodeIgniter4 на вашей системе.

Первые два способа описывают создание скелета проекта с использованием CodeIgniter4, который вы затем будете использовать в качестве основы для нового веб-приложения. Третий способ, описанный ниже, позволяет добавить CodeIgniter4 в существующее веб-приложение.

Запуск приложения

Репозиторий запуска приложения CodeIgniter 4 содержит скелетное приложение с зависимостью Composer от последней релизной версии фреймворка.

Этот способ установки подходит для разработчика, который хочет начать новый проект на основе CodeIgniter4.

Установка и настройка

В папке выше корня вашего проекта:

composer create-project codeigniter4/appstarter project-root

Команда выше создаст папку «project-root».

Если вы опустите аргумент «project-root», команда создаст папку «appstarter», которую можно переименовать по своему усмотрению.

Если вам не нужен или не нужен phpunit и все его зависимости Composer, добавьте параметр --no-dev в конец вышеприведенной команды. Это приведет к установке только фреймворка и трех надежных зависимостей, которые мы объединяем.

Пример такой команды установки, использующей по умолчанию проект-корень «appstarter»:

composer create-project codeigniter4/appstarter --no-dev

После установки вам следует выполнить шаги в разделе «Обновление».

Обновление

Всякий раз, когда выходит новая версия, из командной строки в корне вашего проекта:

composer update

Если вы хотите сравнить последнюю структуру исходного кода фреймворка для папок, которые не являются системными (app, public и т. д.), вы можете обновить с помощью --prefer-source:

composer update codeigniter4/framework --prefer-source

Если --prefer-source не обновляется автоматически, чтобы получить последнюю структуру исходного кода фреймворка, вы можете сначала удалить:

rm -rf vendor/codeigniter4/framework && composer update codeigniter4/framework --prefer-source

Если вы использовали параметр --no-dev при создании проекта, то аналогично следует поступить и здесь, т. е. composer update --no-dev.

Прочитайте инструкции по обновлению и проверьте указанные папки app/Config на наличие изменений.

Преимущества

Простая установка; простое обновление

Недостатки

После обновления все равно необходимо проверить изменения app/Config

Структура

Папки в вашем проекте после настройки:

• app, public, tests, writable
• vendor/codeigniter4/framework/system
• vendor/codeigniter4/framework/app & public (сравните со своими после обновления, когда используется --prefer-source)

Последняя версия (dev)

Репозиторий App Starter поставляется с скриптами builds для переключения источников Composer между текущей стабильной версией и последней веткой разработки фреймворка. Используйте этот скрипт для разработчика, который готов работать с последними, возможно нестабильными, ещё не выпущенными изменениями.

Руководство пользователя для разработчиков доступно онлайн. Обратите внимание, что это отличается от опубликованного руководства пользователя и относится конкретно к ветке develop.

В корне вашего проекта:

php builds development

Команда выше обновит composer.json, чтобы указать на ветку develop рабочего репозитория, и обновит соответствующие пути в файлах конфигурации и XML. Чтобы отменить эти изменения, выполните:

php builds release

После использования команды builds обязательно выполните composer update для синхронизации папки vendor с последней целевой сборкой.

Добавление CodeIgniter4 в существующий проект

Тот же репозиторий фреймворка CodeIgniter 4, описанный в разделе «Установка вручную», также может быть добавлен в существующий проект с использованием Composer.

Разрабатывайте приложение внутри папки app, а папка public будет корневым каталогом документов.

В корне вашего проекта:

composer require codeigniter4/framework --prefer-source

Как и в предыдущих двух методах установки Composer, вы можете отказаться от установки phpunit и его зависимостей, добавив аргумент --no-dev к команде composer require.

Настройка

Скопируйте папки app, public, и writable из vendor/codeigniter4/framework в корень вашего проекта.

Скопируйте файлы env, phpunit.xml.dist и spark из vendor/codeigniter4/framework в корень вашего проекта.

Вам нужно будет изменить путь к системе, чтобы он ссылался на папку vendor, например, ROOTPATH . '/vendor/codeigniter4/framework/system', - переменную $systemDirectory в файле app/Config/Paths.php

Обновление

Всякий раз, когда выходит новая версия, из командной строки в корне вашего проекта:

composer update --prefer-source

Прочитайте инструкции по обновлению и проверьте указанные папки app/Config на наличие изменений.

Преимущества

Относительно простая установка; простое обновление

Недостатки

После обновления все равно необходимо проверить изменения app/Config

Структура

Папки в вашем проекте после настройки:

• app, public, writable (при использовании --prefer-source)
• vendor/codeigniter4/framework/system

Установка переводов

Если вы хотите использовать системные переводы сообщений, их можно добавить в ваш проект аналогичным образом.

Из командной строки внутри корня вашего проекта:

composer require codeigniter4/translations

Они будут обновляться вместе с фреймворком всякий раз, когда вы выполняете composer update.