Getting Started
To quickly test or to quickly start a new Piko based project, the recommended way is to use the Piko project skeletton.
Piko project skeletton installation
If you don’t have Composer installed on your system, you may install it by following the instructions at getcomposer.org.
Then install your project template using the following command:
composer create-project piko/project yourprojectname
Run your app
Once the project installed (see above), you can run it using the PHP built-in web server :
cd yourprojectname && php -S localhost:8080 -t web
You should see the interface bellow in your Web browser if you go to http://localhost:8080/
Hello world example
Once the project created (see above) create a new controller file in modules/site/controllers
named HelloController.php
.
and edit the file with this code :
<?php
namespace app\modules\site\controllers;
class HelloController extends \Piko\Controller
{
public function worldAction()
{
return "<h1>Hello world!</h1>";
}
}
Then open the URL : http://localhost:8080/site/hello/world
You should see `Hello world!’ in your browser.
The URI /site/hello/world
corresponds by default to the module site
, the controller hello
and the action world
.
It’s possible to customize the URI by editing the file config/routes.php and add a new route like this :
return [
'/' => 'site/default/index',
// ...
'/hello-world' => 'site/hello/world'
];
You will obtain the same result than above with this URL : http://localhost:8080/hello-world
Rather than generate html code directly in the controller, it’s possible to use a separate file.
Create a new file world.php
in modules/site/views/hello
(create before the directory hello) with this content :
<h1>Hello World!</h1>
In modules/site/controllers/HelloController.php
we can rewrite the method worldAction
like this :
public function worldAction()
{
return $this->render('world');
}
This will render the content of the file modules/site/views/hello/world.php
.