kaleidpixel/codeigniter4-blank

CodeIgniter4 starter app

dev-main 2024-02-05 11:04 UTC

This package is auto-updated.

Last update: 2024-04-05 11:38:28 UTC


README

What is CodeIgniter?

CodeIgniter is a PHP full-stack web framework that is light, fast, flexible and secure. More information can be found at the official site.

This repository holds a composer-installable app starter. It has been built from the development repository.

More information about the plans for version 4 can be found in CodeIgniter 4 on the forums.

The user guide corresponding to the latest version of the framework can be found here.

Installation & updates

composer create-project kaleidpixel/codeigniter4-blank then composer update whenever there is a new release of the framework.

When updating, check the release notes to see if there are any changes you might need to apply to your app folder. The affected files can be copied or merged from vendor/codeigniter4/framework/app.

Setup

Adjust the ".env" to suit your app, especially the base URL. and database settings.

We have adopted Twig as the template engine. To use Twig with CodeIgniter 4, the library kaleidpixel/codeigniter4-twig, which is a customized fork of daycry/twig published by Mr. daycry, is used. Execute the following command.

php spark twig:publish

When using Shield, the official authentication and authorization framework for CodeIgniter 4, execute the following command. Please refer to the official documentation for Shield.

php spark shield:setup

Important Change with index.php

index.php is no longer in the root of the project! It has been moved inside the public folder, for better security and separation of components.

This means that you should configure your web server to "point" to your project's public folder, and not to the project root. A better practice would be to configure a virtual host to point there. A poor practice would be to point your web server to the project root and expect to enter public/..., as the rest of your logic and the framework are exposed.

Please read the user guide for a better explanation of how CI4 works!

Repository Management

We use GitHub issues, in our main repository, to track BUGS and to track approved DEVELOPMENT work packages. We use our forum to provide SUPPORT and to discuss FEATURE REQUESTS.

This repository is a "distribution" one, built by our release preparation script. Problems with it can be raised on our forum, or as issues in the main repository.

Server Requirements

PHP version 7.4 or higher is required, with the following extensions installed:

Warning The end of life date for PHP 7.4 was November 28, 2022. If you are still using PHP 7.4, you should upgrade immediately. The end of life date for PHP 8.0 will be November 26, 2023.

Additionally, make sure that the following extensions are enabled in your PHP:

  • json (enabled by default - don't turn it off)
  • mysqlnd if you plan to use MySQL
  • libcurl if you plan to use the HTTP\CURLRequest library