PHP's FIG and PSRs

PHP’s FIG and PSRs*

*or how to come up with a title made up of acronyms
miércoles 6 de noviembre de 13

ABOUT ME


Javier López

I work in London

I was born in Spain


Lead Engineer at Time Out
Previously worked for IPC Media and Sensio Labs


www.desymfony.com

me


AGENDA


1.

FIG

2.

PSRs

3.

SWN


#1
Framework
Interoperability
Group


David Zülke

M. Dowling

Leo Feyer

G. Blanco

Larry Garﬁeld

Taylor Otwell

Nate Abele

Brett Bieber

P. Sturgeon

Evert Pot

John Mertic


Ivan Habunek

Kris Wallsmith

Paul Jones

Larry Masters

Jordi Boggiano

André Romcke K. Dambekalns Lukas Smith

Don Gilbert

Nils Adermann Mike van Riel Paul Dragoonis

Will Durand

B. Schussek

Cal Evans

Alex. Makarov

Pádraic Brady

Do you want to become a
member?


#2
PHP
Standards
Recomendation


PSR-0 Autoloading
PSR-1 Basic Coding Standards
PSR-2 Coding Style Guide
PSR-3 Logger Interface


PSR-0
Autoloading


DoctrineCommonIsolatedClassLoader
/path/to/lib/vendor/Doctrine/Common/IsolatedClassLoader.php


ZendAcl
/path/to/lib/vendor/Zend/Acl.php


VendorPackageClass_Subclass
/path/to/lib/vendor/Vendor/Package/Class/Subclass.php


VendorWith_UnderscoresClass
/path/to/lib/vendor/Vendor/With_Underscores/Class.php


SplClassLoader implementation

http://gist.github.com/221634

Composer

http://getcomposer.org

PSR-1
Basics Coding Standards


Files must use only <?php and <? tags


Files SHOULD either declare symbols or
cause side-effects but SHOULD NOT do
both.


Namespaces and classes follow PSR-0


Class names declared in StuldyCaps


Class constants MUST be
UPPERCASED_WITH_UNDERSCORES_SEPARATORS


Class methods declared in camelCase


PSR-2
Coding Styling Guide


Namespaces and classes follow PSR-1


<?php
namespace VendorPackage;
use FooInterface;
use BarClass as Bar;
use OtherVendorOtherPackageBazClass;
class Foo extends Bar implements FooInterface
{
public function sampleFunction($a, $b = null)
{
if ($a === $b) {
bar();
} elseif ($a > $b) {
$foo->bar($arg1);
} else {
BazClass::bar($arg2, $arg3);
}
}
final public static function bar()
{
// method body
}
}

<?php LF
namespace VendorPackage; LF
use FooInterface; LF
use BarClass as Bar; LF
use OtherVendorOtherPackageBazClass; LF
class Foo extends Bar implements FooInterface LF
{
public function sampleFunction($a, $b = null) LF
{ LF
if ($a === $b) { LF
bar(); LF
} elseif ($a > $b) { LF
$foo->bar($arg1); LF
} else { LF
BazClass::bar($arg2, $arg3); LF
} LF
} LF
final public static function bar() LF
{ LF
// method body
} LF
} LF
LF

<?php
use FooInterface;
{
{
if ($a === $b) {
bar();
$foo->bar($arg1);
} else {
}
}
{
// method body
}
}

80

120

PHP keywords all lowercase


true, false and null all lowercase


<?php
LF

use FooInterface;
LF

{
{
if ($a === $b) {
bar();
$foo->bar($arg1);
} else {
}
}
{
// method body
}
}

<?php
use FooInterface;
{
public $foo = null;
final public static function bar($arg1, &$arg2)
{
// body
}
}


and the list goes on and on and on
... methods and function calls
... control structures
... closures
... multiple lines
...
http://www.php-fig.org/psr/psr-2/


> phpcs --standard=PSR2 *.php

https://github.com/squizlabs/PHP_CodeSniffer


> php php-cs-fixer.phar fix .

https://github.com/fabpot/PHP-CS-Fixer


PSR-3
Logger Interface


<?php
namespace PsrLog;
interface LoggerInterface
{
public function alert($message, array $context = array());
public function critical($message, array $context = array());
public function error($message, array $context = array());
public function warning($message, array $context = array());
public function notice($message, array $context = array());
public function info($message, array $context = array());
public function debug($message, array $context = array());
public function log($level, $message, array $context = array());
}


RFC 5424
Emergency – the system is unusable
Alert – immediate action is required
Critical – critical conditions
Error – errors that do not require immediate attention but should be monitored
Warning – unusual or undesirable occurrences that are not errors
Notice – normal but signiﬁcant events
Info – interesting events
Debug – detailed information for debugging purposes

http://tools.ietf.org/html/rfc5424

$message = "{DB}: SELECT * FROM user";
$context = array("DB" => "MY_PROJECT");
$logger->debug($message, $context); // "MY PROJECT": SELECT * FROM user"


Helper classes and interfaces


<?php
namespace PsrLog;
abstract class AbstractLogger implements LoggerInterface
{
    public function emergency($message, array $context = array())
    {
        $this->log(LogLevel::EMERGENCY, $message, $context);
    }
.
.
.
    public function debug($message, array $context = array())
    {
        $this->log(LogLevel::DEBUG, $message, $context);
    }
}


<?php
namespace PsrLog;
trait LoggerTrait
{
    public function emergency($message, array $context = array())
    {
        $this->log(LogLevel::EMERGENCY, $message, $context);
    }
.
.
.
    abstract public function log($level, message, array $context)
}


<?php
namespace PsrLog;
class NullLogger extends AbstractLogger
{
public function log($level, $message, array $context = array())
{
}
}


<?php
namespace PsrLog;
interface LoggerAwareInterface
{
public function setLogger(LoggerInterface $logger);
}


<?php
namespace PsrLog;
class LogLevel
{
const EMERGENCY
const ALERT
const CRITICAL
const ERROR
const WARNING
const NOTICE
const INFO
const DEBUG
}


=
=
=
=
=
=
=
=

'emergency';
'alert';
'critical';
'error';
'warning';
'notice';
'info';
'debug';

https://github.com/php-ﬁg/log


{
    "require": {
        "psr/log": "dev-master"
    }
}


Monolog

https://github.com/Seldaek/monolog

#3
So
What
Now?


PSR-4?


My humble opinion


Thanks! Questions?

@loalf

PHP's FIG and PSRs

Recomendados

Recomendados

Más contenido relacionado

La actualidad más candente

La actualidad más candente (13)

Similar a PHP's FIG and PSRs

Similar a PHP's FIG and PSRs (20)

Más de Javier López

Más de Javier López (8)

Último

Último (20)

PHP's FIG and PSRs