Lithium Best

Lithium (#li3)
The framework with the best of both worlds

Richard McIntyre: @mackstar

★ Lithium core team

★ Freelancer - Leeds/Manchester

★ Most recently at BBC, Mamas & Papas, UOR

★ Engineer on BBC Olympics App

★ Lived in Japan 15 years

★ Done PHP for donkeys

I’ve seen it
✦ Symfony 2 ✦ Merb

✦ Zend Framework ✦ Sinatra

✦ CakePHP ✦ Spring

✦ Code Igniter ✦ Stripes (Java)

✦ Drupal 6&7 ✦ Django
Wordpress
✦ Silex
✦

✦ Rails

Each software solution should be in proportion to
the problem being solved.


-some lazy bugger


-some lazy bugger
me

<?php

use BehatMinkExtensionContextMinkContext;

class FeatureContext extends MinkContext
{
/**
* @Then /^I wait for the suggestion box to appear$/
*/
public function myNameHasAMeaninglessExistance()
{
$this->getSession()->wait(5000, "$('.suggestions-results').children().length >
0");
}
}

All problems in computer science can be solved
by another level of indirection. Except for the
problem of too many layers of indirection.

Butler Lampson, David Wheeler

Code Sexy-ness
There’s nothing like the look of beautiful Ruby code in the morning.
Gracefully colored by TextMate and rendered in Bitstream Vera pt 12.
@dhh

Developer Happy-ness
Any fool can write code that a computer can understand. Good
programmers write code that humans can understand.
–Martin Fowler

Looking for a hackers Framework?

Light Footprint

World 1

Full Stack Framework
Convention Over Conﬁguration

github.com/UnionOfRad/framework

The Photo Blog Tutorial
github.com/nateabele/photoblog

Model
namespace photoblogmodels;

class Photos extends lithiumdataModel {

public $validates = array();

protected $_meta = array('source' => 'fs.ﬁles');

public function save($entity, $data = null, array $options = array()) {
if ($data) {
$entity->set($data);
}
if ($entity->tags && !is_array($entity->tags)) {
$entity->tags = array_map('trim', explode(',', $entity->tags));
}
return parent::save($entity, null, $options);
}
}

Views

<?=$this->form->create($photo, array('type' => 'file')); ?>
<?=$this->form->field('title'); ?>
<?=$this->form->field('description'); ?>
<?php if (!$photo->exists()): ?>
<?=$this->form->field('file', array('type' => 'file')); ?>
<?php endif; ?>
<?=$this->form->field('tags', array('label' =>
'Add tags separated by commas')); ?>
<?=$this->form->submit('Save'); ?>
<?=$this->form->end(); ?>

<h1>
<?=$this->title($photo->title); ?>
<em>[
<?=$this->html->link(
'edit', array('Photos::edit', 'id' => $photo->_id)
); ?> ]</em>
</h1>

<p><?=$photo->description; ?></p>

<?php if ($photo->tags): ?>
Tags:
<?php foreach ($photo->tags as $tag): ?>
<?=$this->html->link(
$tag, array('Photos::index', 'args' => array($tag))
); ?>
<?php endforeach; ?>
<?php endif; ?>

<?=$this->html->image(
"/photos/view/{$photo->_id}.jpeg", array(
'alt' => $photo->title, 'width' => "100%"
)
); ?>

Controller

namespace photoblogcontrollers;

use photoblogmodelsPhotos;
use li3_geoextensionsGeocoder;

class PhotosController extends lithiumactionController {

public function index($tags = null) {
$conditions = $tags ? compact('tags') : array();
$photos = Photos::all(compact('conditions'));
return compact('photos');
}

public function view() {
$photo = Photos::ﬁrst($this->request->id);
return compact('photo');
}

public function near($place = null) {
$this->_render['template'] = 'index';
$coords = Geocoder::ﬁnd('google', $place);

$photos = Photos::within(array($coords, $coords), array('limit' => 1));
}

public function add() {
$photo = Photos::create();
if (($this->request->data) && $photo->save($this->request->data)) {
$this->redirect(array('Photos::view', 'id' => $photo->_id));
}
$this->_render['template'] = 'edit';
}

public function edit() {
$photo = Photos::ﬁnd($this->request->id);
if (!$photo) {
$this->redirect('Photos::index');
}
}
}

public function near($place = null) {
$this->_render['template'] = 'index';
$coords = Geocoder::ﬁnd('google', $place);

$photos = Photos::within(array($coords, $coords), array('limit' => 1));
}

public function add() {
$photo = Photos::create();
Geo Location
}
$this->_render['template'] = 'edit';
}

public function edit() {
$photo = Photos::ﬁnd($this->request->id);
if (!$photo) {
$this->redirect('Photos::index');
}
}
}

Routes
use lithiumnethttpRouter;
use lithiumcoreEnvironment;
use lithiumactionResponse;

Router::connect('/photos/view/{:id:[0-9a-f]{24}}.jpeg', array(), function($request) {
return new Response(array(
'headers' => array('Content-type' => 'image/jpeg'),
'body' => Photos::ﬁrst($request->id)->ﬁle->getBytes()
));
});

/**
* Connect the testing routes.
*/
if (!Environment::is('production')) {
Router::connect('/test/{:args}', array('controller' => 'lithiumtestController'));
Router::connect('/test', array('controller' => 'lithiumtestController'));
}

Routes

return new Response(array(
'headers' => array('Content-type' => 'image/jpeg'),
));
});

/**
By-Passes
*/
if (!Environment::is('production')) { the framework
}

Routes
use
It’s PHP you can
photoblogmodelsPhotos;

return new Response(array( you
doarray('Content-type' => 'image/jpeg'),
what
'headers' =>
want
));
});

/**
*/
if (!Environment::is('production')) {
}

Features
✦ Full stack MVC ✦ Object based record-
sets
✦ Logger
✦ Command Line
✦ Caching Framework

✦ Sessions/Cookies ✦ Authentication

✦ Full templating suite ✦ Validator

✦ Integrated TDD suite ✦ Http Services

World 2

Kick-ass de-coupled hacker happy framework

Are you a
slave to your
framework?

Flexible, transparent boostrap process

Database

namespace models;

class Posts extends lithiumdataModel {

}

deﬁne('LITHIUM_LIBRARY_PATH', dirname(__DIR__) . '/libraries');
require LITHIUM_LIBRARY_PATH . '/lithium/core/Libraries.php';

use lithiumcoreLibraries;
Libraries::add('lithium');

use lithiumdataConnections;
Connections::add('default', array(
'type' => 'MongoDb',
'database' => 'phpnw',
'host' => 'localhost'
));

Libraries::add('models', array('path' => __DIR__ . '/models'));

use modelsPosts;
$posts = Posts::create(array('title' => 'Hi Guys'));
$posts->save();


Libraries::add('lithium'); Simple lithium setup
));


use modelsPosts;
$posts->save();



'database' => 'phpnw', DB Conﬁg
));


use modelsPosts;
$posts->save();



)); Add models ‘app’

use modelsPosts;
$posts->save();



));

DB Save

use modelsPosts;
$posts->save();

Routes



use lithiumactionRequest;

$request = new Request();
$router = new Router();

$router->connect('/cool-root', array('controller' => 'Yea'));
$router->connect('/cool-root/{:application_id:[0-9]{1}}', array('controller' => 'Yea'));
$router->parse($request);

echo Router::match('Yea::index');
echo Router::match(array('Yea::index', 'application_id' => 1));

/cool-root/4

$router->connect('/cool-root/{:application_id:[0-9]{1}}',
array('controller' => 'Yea'));

/cool-root/4

$router->connect('/cool-root/{:application_id:[0-9]{1}}',
array('controller' => 'Yea'));

object(lithiumactionRequest)[1]
public 'url' => string '/cool-root/4' (length=12)
public 'params' =>
array (size=3)
'application_id' => string '4' (length=1)
'controller' => string 'Yea' (length=3)
'action' => string 'index' (length=5)

Adaptable Classes

deﬁne('LITHIUM_APP_PATH', __DIR__);

require LITHIUM_LIBRARY_PATH . '/lithium/core/Object.php';
require LITHIUM_LIBRARY_PATH . '/lithium/core/StaticObject.php';
require LITHIUM_LIBRARY_PATH . '/lithium/core/Environment.php';
require LITHIUM_LIBRARY_PATH . '/lithium/core/Adaptable.php';

use lithiumcoreAdaptable;

class Email extends Adaptable{

protected static $_conﬁgurations = array();
protected static $_adapters = 'emails';

}

namespace adapters;
Libraries::add('lithium'); class EmailTest
Libraries::add('adapters', {
array('path' => __DIR__ . '/adapters')); public function send() {
Libraries::paths( echo 'email test send';
array('emails' => array( }
'{:library}{:name}'))); }
Email::conﬁg(array(
'development' => array(
'adapter' => 'EmailReal'
), namespace adapters;
'test' => array(
'adapter' => 'EmailTest' class EmailReal
), {
)); public function send() {
echo 'email real send';
use lithiumcoreEnvironment; }
}
Environment::set('test');
$env = Environment::get();

Email::adapter($env)->send();

Environment::set('development');

class EmailAnother extends Adaptable{ Already
protected static $_conﬁgurations = array();
protected static $_adapters = 'emails';
Environment
public static function send() {
static::adapter('default')->send();
Aware
}

}

EmailAnother::conﬁg(array(
'default' => array(
'test' => array (
'adapter' => 'EmailTest'
),
'development' => array(
'adapter' => 'EmailReal'
),
)
));

EmailAnother::send();


require LITHIUM_LIBRARY_PATH . '/lithium/util/Collection.php';
require LITHIUM_LIBRARY_PATH . '/lithium/util/collection/Filters.php';

class Action extends lithiumcoreObject {

public function doSomethingStupid() {
return $this->_ﬁlter(__METHOD__, $params, function($self, $params) {
$result = ‘Your girlfriend is angry at you’;
return $result;
});
}
}

$action = new Action;
$action->applyFilter('doSomethingStupid', function($self, $params, $chain) {
echo 'About to do something stupid,';
$result = $chain->next($self, $params, $chain);
echo 'You IDIOT!!!!!';
return $result;
});

$action->doSomthingStupid();


require LITHIUM_LIBRARY_PATH . '/lithium/util/Collection.php';
require LITHIUM_LIBRARY_PATH . '/lithium/util/collection/Filters.php';

class Action extends lithiumcoreObject {

public function doSomethingStupid() {
return $this->_ﬁlter(__METHOD__, $params, function($self, $params) {
$result = ‘Your girlfriend is angry at you’;
return $result;

}
});
Make
}
Filterable
echo 'About to do something stupid,';
echo 'You IDIOT!!!!!';
return $result;
});


use lithiumanalysisLogger;

Logger::conﬁg(array(
'default' => array(
'adapter' => 'File',
'path' => __DIR__ . '/crap/logs/'
)
));


Logger::debug(date("D M j G:i:s") . " " . 'About to do something stupid,');


Logger::debug(date("D M j G:i:s") . " " . 'You total moron!');

return $result;

});


Posts::applyFilter('ﬁnd', function($self, $params, $chain) {

$search = http_build_query($params['options']);
Logger::debug(
'Search for: ' . $search . 'returned' . $result->to('json')
);
return $result;

});


$key = // Make a cache key from params['options']
if ($result = Cache::read('default', $key)) {
return $result;
}
Cache::write('default', $key, $result));
return $result;

});


Logger::debug(
);
return $result;

});
Logging Filter

return $result;
}
return $result;

});


Logger::debug(

); Caching Filter

return $result;

});


return $result;
}
return $result;

});

Full Page Caching
Cache::conﬁg(array(
'default' => array(
'adapter' =>
'lithiumstoragecacheadapter' . ($apcEnabled ? 'Apc' : 'File')
)
));

Dispatcher::applyFilter('run', function($self, $params, $chain) {
$key = md5(LITHIUM_APP_PATH) . '.app.cache.'.md5($params['request']->url);
if($cache = Cache::read('default', $key)) {
return $cache;
}


Cache::write('default', $key, $result, '+1 day');
return $result;
});

Full Page Caching
Set Cache Conﬁguration
'default' => array(
'adapter' =>
)
));

return $cache;
}


return $result;
});

Full Page Caching
'default' => array(
'adapter' =>
)
));

return $cache;
}

Filter on Dispatcher::run
Cache::write('default', $key, $result, '+1 day'); Checks for cache w/key
return $result;
});

Full Page Caching
'default' => array(
'adapter' =>
)
));

w/out cache content carry on

running - saving to cache
return $cache;
}


return $result;
});

Content Rendering
namespace dispatcher_appcontrollers;

class YeaController extends lithiumactionController{
public function index() {
$yeah = true;
return compact('yeah');
}

public function render(array $options = array()) {
return 'The response of Yeah is: ' . $this->_render['data']['yeah'];
}
}

Content Rendering
namespace dispatcher_appcontrollers;

class YeaController extends lithiumactionController{
public function index() {
$yeah = true;
Overwrite ‘render’ method
return compact('yeah');
}

public function render(array $options = array()) {
return 'The response of Yeah is: ' . $this->_render['data']['yeah'];
}
}




Libraries::add('dispatcher_app', array('path' => __DIR__ . '/dispatcher_app'));


Router::connect('/cool-root', array('controller' => 'Yea', 'library' => 'dispatcher_app'));

echo lithiumactionDispatcher::run(
new lithiumactionRequest()
);




Create Routing



);






Run Dispatcher

);

Media::type('ajax', array('application/xhtml+xml', 'text/html'), array(
'view' => 'lithiumtemplateView',
'paths' => array(
'template' => array(
'{:library}/views/{:controller}/{:template}.ajax.php',
'{:library}/views/{:controller}/{:template}.html.php'
),
'layout' => '{:library}/views/layouts/default.ajax.php'
),
'conditions' => array('ajax' => true)
));

Easily setup
template paths

Media::type('jpg', 'image/jpeg', array('cast' => false, 'encode' => function($data) {
return $data['photo']->ﬁle->getBytes();
}));

Media::type('json', 'application/json', array('cast' => false, 'encode' => function($data) {
return json_encode($data);
}));

Media::type('json', 'application/json', array(
'cast' => false, 'encode' => 'json_encode')
);

}));

Handle Images
}));

);

}));

}));

);
Handle JSON

Error Handling
use lithiumcoreErrorHandler;
use lithiumcoreStaticObject;

class IThrowAnException
{
public function method() {
throw new Exception('Yo');
}
}

class IDontThrow extends StaticObject
{
public static function method($bar) {
static::_ﬁlter(__FUNCTION__, $params, function($self, $params) {
$object = new IThrowAnException;
$object->method();
});
}
}

ErrorHandler::apply('IDontThrow::method', array(), function($info, $params) {
echo 'Exception raised with message - ' . $info['exception']->getMessage();
});

IDontThrowAnException::method();

Error Handling
use lithiumcoreErrorHandler;
use lithiumcoreStaticObject;

class IThrowAnException
{
public function method() {
throw new Exception('Yo');
} Filterable
}

class IDontThrow extends StaticObject
{
public static function method($bar) {
static::_ﬁlter(__FUNCTION__, $params, function($self, $params) {
$object = new IThrowAnException;
$object->method();
});
}
}

ErrorHandler::apply('IDontThrow::method', array(), function($info, $params) {
echo 'Exception raised with message - ' . $info['exception']->getMessage();
});

IDontThrowAnException::method();

ErrorHandler::apply('lithiumactionDispatcher::run', array(),
function($info, $params) {
$response = new Response(array(
'request' => $params['request'],
'status' => $info['exception']->getCode(),
'trace' => $info['exception']->getTrace(),
));

Media::render($response, compact('info', 'params'), array(
'controller' => 'errors',
'template' => 'default',
'layout' => 'default',
'library' => 'golf',

));
return $response;
});

Example

Create
Response
));

'library' => 'golf',

));
return $response;
});

Example

));

'library' => 'golf', Media
Render
));
return $response;
});

Example

Zendy Love

Libraryies::add(
'preﬁx' => 'Zend_',
'includePath' => '/htdocs/libraries/Zend/trunk/library',
'bootstrap' => 'Loader/Autoloader.php',
'loader' => array('Zend_Loader_Autoloader', 'autoload'),
'transform' => function($class) { return str_replace('_', '/', $class) . '.php'; }
);

deﬁne('LITHIUM_APP_PATH', __DIR__ . '/templates');


use lithiumactionDispatcher;
use lithiumg11nMessage;
use lithiumnethttpMedia;

Libraries::add('li3_docs');
Libraries::add('templates', array('path' => __DIR__ . '/templates',
'default' => true));
Libraries::add('adapters', array('path' => __DIR__ . '/adapters'));

Libraries::add('li3_docs', array(
'index' => array('lithium', 'adapters')
));

Libraries Example

deﬁne('LITHIUM_APP_PATH', __DIR__ . '/templates');


use lithiumcoreLibraries; Sets up
use
use
lithiumactionDispatcher;
lithiumg11nMessage;
Libraries
use lithiumnethttpMedia;

Libraries::add('li3_docs');
Libraries::add('templates', array('path' => __DIR__ . '/templates',
'default' => true));
Libraries::add('adapters', array('path' => __DIR__ . '/adapters'));

Libraries::add('li3_docs', array(
'index' => array('lithium', 'adapters')
));

Libraries Example

$locale = 'en';
$locales = array('en' => 'English');

Environment::set('development', compact('locale', 'locales'));
Environment::set('development'); }
$file = "{$config['path']}/config/routes.php";
file_exists($file) ? call_user_func(function() use ($file) { include $file; }) : null;
}
return $chain->next($self, $params, $chain);
});

Media::applyFilter('_handle', function($self, $params, $chain) {
$params['handler'] += array('outputFilters' => array());
$params['handler']['outputFilters'] += Message::aliases();
});

echo lithiumactionDispatcher::run(new lithiumactionRequest());

Locale &
$locale = 'en';
Routes

}
});

});


$locale = 'en';

}
});

Gets
}); translations

$locale = 'en';

}
});

});


Go

★ Hackers framework
Recap

Recap
★ Light, fast & fun

Recap

★ Services have adaptable base

Recap


★ Filters are awesome/powerful

Recap



★ Everything is a library

Recap




★ As much or as little framework as you
need

Recap




★ As much or as little framework as you
need

★ Great balance weight/power/simplicity

Thanks
github.com/mackstar/phpnw-li3

@mackstar | #mackstar

Lithium Best

More Related Content

What's hot (20)

Viewers also liked (20)

Similar to Lithium Best (20)

More from Richard McIntyre (8)

Lithium Best

Editor's Notes