Git Installation
This would not be suitable for app development, but is suitablefor contributing to the framework.
Installation
Install the latest version of the codebase by
- forking the codebase to your github account
- cloning your forked repository locally
Setting Up
The command above will create a “CodeIgniter4” folder.Feel free to rename that as you see fit.
You will want to set up a remote repository alias, so you can synchronizeyour repository with the main one:
- git remote add upstream https://github.com/codeigniter4/CodeIgniter4.git
Copy the provided env
file to .env
, and use that for your git-ignored configuration settings,
Copy the provided phpunit.xml.dist
to phpunit.xml
and tailor it as needed,if you want custom unit testing for the framework.
Upgrading
Update your code anytime:
- git checkout develop
- git pull upstream develop
- git push origin develop
Merge conflicts may arise when you pull from “upstream”.You will need to resolve them locally.
Pros
- You have the latest version of the codebase (unreleased)
- You can propose contributions to the framework, by creating a
- feature branch and submitting a pull request for it to the main repo
- a pre-commit hook is installed for your repo, that binds it to the
- coding-standard we use
Cons
You need to resolve merge conflicts when you synch with the repo.
You would not use this technique for app development.
Structure
Folders in your project after set up:
- app, public, system, tests, user_guide_src, writable
Translations Installation
If you wish to contribute to the system message translations,then fork and clone the translations repository separately from the codebase.These are two independent repositories!
Coding Standards Installation
This is bound and installed automatically as part of thecodebase installation.
If you wish to use it inside your project too,composer require codeigniter4/translations @beta