jelix-skeleton-app

Application skeleton to start a new project with the Jelix framework., _(*1)

Only for the Jelix master branch (unstable). For stable version of jelix, see other branches of the jelix-skeleton-app git repository., _(*2)

Installation

Install Composer. For example on Linux or MacOs:, _(*3)

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

Then create your project, let's say 'myapp', using the source code of jelix-skeleton-app:, _(*4)

composer create-project jelix/jelix-skeleton-app myapp dev-master

And go into the newly created folder for next commands, _(*5)

cd myapp/

The next thing to do is to setup the application:, _(*6)

# copy the file where 
cp var/config/profiles.ini.php.dist var/config/profiles.ini.php

# an empty file to indicate local configuration values
cp var/config/localconfig.ini.php.dist var/config/localconfig.ini.php

# run the Jelix installer
php install/installer.php

Create a link to the jelix-www of jelix. Jelix-www contains web resources for some Jelix components:, _(*7)

ln -s ../vendor/jelix/jelix/lib/jelix-www www/jelix

or copy the directory, _(*8)

cp -a ../vendor/jelix/jelix/lib/jelix-www www/jelix

Then you can launch the Php web server, _(*9)

php -S localhost:8080 -t www

And see your first page in your browser at the URL: http://localhost:8080., _(*10)

You are ready to develop your application and modules ;-), _(*11)

Note: use the PHP web server only for development. Use production ready web server like Apache or Nginx to run the application for production., _(*12)

name & informations

In some comments header and other files, there is the name of the application "jelix-skeleton-app". You should probably change it. You should also probably want to change informations into the .jelix-scripts.ini file, in the composer.json file and in the project.xml file., _(*13)

licence and copyright

The source code files are not released under a licence. So you have to choose a licence and you should update the LICENSE file, the composer file and all comments header of other files., _(*14)

installation without Composer

Retrieve the Jelix archive. You'll find a create-jelix-app.php script in it which creates from scratch the skeleton app. See the documentation., _(*15)