Lipid

Lipid is an objects designed microframework for PHP web apps.

Quickstart

Create app directory:

$ mkdir testapp
$ composer require agorlov/lipid

Lipid is installed, start with example app, run:

$ vendor/bin/lipidstrap

3 files will be created:

• index.php - it's your app, it consists of actions-objects for each page or request;
• src/ActIndex.php - it's example action for main page;
• tpl/index.twig - it's example index page template.

And start your app:

$ php -S localhost:8000 index.php

Finaly open browser: http://localhost:8000

Enjoy Result and start creating your app pages.

How to create Actions (pages or api-responses)

ActIndex.php

<?phpclass ActIndex implements Action
{
publicfunctionhandle(Response$resp): Response
{
return$resp->withBody(
"Hello, World 2!<br>" . '<a href="/login">login</a>'
);
}
}

If we need database or GET params, put it in constructor:

In this example $_GET['test'] -> with $this->GET array

<?phpclass ActIndex implements Action
{
private$rqGet;
publicfunction__construct(array$GET = null)
{
$this->rqGet = $GET ?? $_GET;
}
publicfunctionhandle(Response$resp): Response
{
$test = $this->GET['test'] ?? 'nothing';
return$resp->withBody(
"Hello, World 2!<br>" . '<a href="/login">login</a>' .
'$_GET[test]=' . htmlentities($test)
);
}
}

GET request, POST request, Database, Config, Environment, Session:

<?phppublicfunction__construct(
array$GET = null, AppPDO$db = null, Config$config = null, Request$env = null,
Session$sess = null,
Tpl$tpl// or anything you need for your Action
) {
$this->POST = $GET ?? $_POST;
$this->GET = $GET ?? $_GET;
$this->db = $db ?? newAppPDO;
$this->config = $config ?? newCfgFile;
$this->env = $env ?? newRqENV;
$this->tpl = $tpl ?? new AppTpl
}

Design principles

1. True OOP:

• each object is representation of domain term
• no static,
• small objects,
• without extends,
• wide use of decorators,
• strict CI/CD piplene: unit tests, PSR2 checker,
• immutable
• inspired by @yegor256 Elegant Objects

2. Micro-format, like lipid is.

3. From Lipid framework to Lipid as process (including design principles, rules, ci/cd)

Library development cycle

1. Clone repository

2. $ composer install

3. $ composer dump-autoload

4. $ composer example

5. open browser: http://localhost:8000/

6. look at the source code: example/ directory.

7. Put some changes, create branch for issue:

$ git checkout -b 'Issue123'

8. Check and fix PSR2 $ composer phpcs and $composer phpcs-fix

9. Check by unit tests:

$ composer tests

10. commit, push and create PR.

git commit -m 'Thats was done closes #123' -a
git push --set-upstream origin Issue123

PHPMD

@todo #75 setup and add phpmd to merge checks

To disable some nasty rule, add comment:

1. run phpmd: $ composer phpmd-xml
2. look at rule name
3. add string @SuppressWarnings("rule name") to phpdoc block of method or class

/**
* Class Title
*
* ..
* @SuppressWarnings("ElseExpression")
* ..
*/