Dependency injection

Dependency Injection no PHP 5.3
Guilherme Blanco – Yahoo!

2
Guilherme Blanco
● 10+ anos como desenvolvedor
● Evangelista Open Source
● Trabalha para Yahoo!
● Contribui para Doctrine, Zend Framework, Symfony e
PHP
● No Twitter: @guilhermeblanco
● No GitHub: http://github.com/guilhermeblanco

3
Um exemplo real na web
Esta palestra é uma tradução de: Dependency Injection in PHP 5.3
Concedida pelo autor Fabien Potencier

4
● Na maioria das aplicações web, você precisa
gerenciar as preferências do usuário:
● A linguagem do usuário
● Se o usuário está autenticado ou não
● As credenciais do usuário
● ...

5
● Isto pode ser feito no objeto User (Usuário):
● setLanguage(), getLanguage()
● setAuthenticated(), getAuthenticated()
● addCredential(), hasCredential()
● ...

6
● As informações do Usuário precisam ser persistidas
entre requisições HTTP
● Nós usamos sessões em PHP para Storage
(Armazenagem)

7
<?php
class SessionStorage
{
  function __construct($cookieName = 'PHP_SESS_ID')
  {
    session_name($cookieName);
    session_start();
  }
  function set($key, $value)
  {
    $_SESSION[$key] = $value;
  }
  // ...
}

8
Muito difícil
de
customizar
Muito fácil
de
usar
<?php
class User
{
  protected $storage;
  function __construct()
  {
    $this>storage = new SessionStorage();
  }
  function setLanguage($language)
  {
    $this>storage>set('language', $language);
  }
  // ...
}
$user = new User();

9
Muito fácil
de
customizar
Um pouco
mais difícil
de usar
<?php
class User
{
  protected $storage;
  function __construct($storage)
  {
    $this>storage = $storage;
  }
}
$storage = new SessionStorage();
$user = new User($storage);

10
● Isto é Dependency Injection (Injeção de Dependência)
● Nada além disso...

11
● Vamos entender porque o primeiro exemplo não é
uma boa idéia...
● Quero mudar o nome do cookie da sessão do usuário

12
Hardcode
na classe
do Usuário
<?php
class User
{
  protected $storage;
  {
    $this>storage = new SessionStorage('SESSION_ID');
  }
  function setLanguage($language)
  {
    $this>storage>set('language', $language);
  }
  // ...
}
$user = new User();

13
Adicionar
uma variável
global?
<?php
class User
{
  protected $storage;
  {
    $this>storage = new SessionStorage(STORAGE_SESSION_NAME);
  }
}
define('STORAGE_SESSION_NAME', 'SESSION_ID');
$user = new User();

14
Configurar
via
Usuário?
<?php
class User
{
  protected $storage;
  function __construct($sessionName)
  {
    $this>storage = new SessionStorage($sessionName);
  }
}
$user = new User('SESSION_ID');

15
Configurar
com um
Array?
<?php
class User
{
  protected $storage;
  function __construct($storageOptions)
  {
    $this>storage = new SessionStorage($storageOptions['session_name']);
  }
}
$user = new User(array('session_name' => 'SESSION_ID'));

16
● Eu quero mudar a implementação de armazenamento
da sessão
● Sistema de Arquivos
● MySQL
● Memcached
● etc

17
Usar uma
instância no
Registro global?
<?php
class User
{
  protected $storage;
  {
    $this>storage = Registry::get('session_storage');
  }
}
Registry::set('session_storage', $storage);
$user = new User();

18
Agora, o Usuário (User) depende do Registro

19
● Ao invés da dependência do Storage estar
“hardcoded” no construtor da classe Usuário
● Injete a dependência de Storage no objeto Usuário

20
<?php
class User
{
  protected $storage;
  {
  }
}
$storage = new SessionStorage('SESSION_ID');

21
Quais as vantagens?

22
Usar uma estratégia de Storage diferente

23
Uso de uma
estratégia diferente
de Storage
<?php
class User
{
  protected $storage;
  {
  }
}
$storage = new MySQLSessionStorage('SESSION_ID');

24
A configuração fica natural

25
A configuração
fica natural
<?php
class User
{
  protected $storage;
  {
  }
}
$storage = new MySQLSessionStorage('SESSION_ID');

26
Engloba classes de terceiros (Adapter/Interface)

27
Adiciona
uma interface
<?php
class User
{
  protected $storage;
  function __construct(SessionStorageInterface $storage)
  {
  }
}
interface SessionStorageInterface
{
  function get($key);
  function set($key, $value);
}

28
Mock do objeto Storage (para testes)

29
Mock de uma
Session
class User
{
  protected $storage;
  function __construct(SessionStorageInterface $storage)
  {
  }
}
class SessionStorageForTests implements SessionStorageInterface
{
  protected $data = array();
  public function set($key, $value)
  {
    $this>data[$key] = $value;
  }
  public function get($key)
  {
    return $this>data[$key];
  }
}

30
● Uso de diferentes estratégias de Storage
● Configuração fica natural
● Engloba classes de terceiros (Adapter/Interface)
● Mock do objeto Storage (para testes)
● Fácil sem alterar a classe Usuário (User)

31
“Dependency Injection é onde os objetos obtém
suas dependências através do construtor,
métodos ou diretamente nas propriedades”
http://www.picocontainer.org/injection.html

32
<?php
// constructor injection
// setter injection
$user = new User();
$user>setStorage($storage);
// property injection
$user = new User();
$user>storage = $storage;

33
Um exemplo web um pouco mais complexo

34
<?php
$request = new Request();
$response = new Response();
$storage = new FileSessionStorage('SESSION_ID');
$cache = new FileCache(
array('dir' => dirname(__FILE__) . '/cache')
);
$routing = new Routing($cache);

35
<?php
class Application
{
  {
    $this>request = new WebRequest();
    $this>response = new WebResponse();
    $this>user = new User($storage);
      array('dir' => dirname(__FILE__).'/cache')
    );
    $this>routing = new Routing($cache);
  }
}
$application = new Application();

36
De volta à estaca zero

37
<?php
class Application
{
  {
    $this>request = new WebRequest();
    $this>response = new WebResponse();
    $this>user = new User($storage);
      array('dir' => dirname(__FILE__).'/cache')
    );
    $this>routing = new Routing($cache);
  }
}
$application = new Application();

38
● Nós precisamos de um Container
● Descreve objetos e suas dependências
● Instancia e configura objetos sob demanda

39
● Um Container DEVE ser capaz de gerenciar
QUALQUER objeto PHP (POPO)
● Os objetos NÃO DEVEM saber que são gerenciados
por um Container

40
● Parâmetros
● A implementação de SessionStorageInterface que
queremos usar (o nome da classe)
● O nome da sessão
● Objetos
● SessionStorage
● User
● Dependências
● Usuário depende de uma implementação de
SessionStorageInterface

41
Vamos criar um simples Container com o PHP 5.3

42
DIC (Dependency Injection Container)
Gerenciando parâmetros

43
<?php
class Container
{
  protected $parameters = array();
  public function setParameter($key, $value)
  {
    $this>parameters[$key] = $value;
  }
  public function getParameter($key)
  {
    return $this>parameters[$key];
  }
}

44
<?php
$class = $container>getParameter('storage_class');
$sessionStorage = new $class($container>getParameter('session_name'));
$user = new User($sessionStorage);
<?php
$container = new Container();
$container>setParameter('session_name', 'SESSION_ID');
$container>setParameter('storage_class', 'SessionStorage');
Criação de Objeto
Customização
Desacoplamento

45
<?php
class Container
{
  public function __set($key, $value)
  {
  }
  public function __get($key)
  {
  }
}

46
<?php
$container>session_name = 'SESSION_ID';
$container>storage_class = 'SessionStorage';
$sessionStorage = new $container>storage_class($container>session_name);
$user = new User($sessionStorage);
Interface é
mais limpa

47
Gerenciando objetos

48
● Precisamos de uma forma para descrever como criar
objetos, sem na realidade instanciar qualquer coisa!
● Funções anônimas existem para nos salvar!

49
Funções anônimas / Lambdas
● Função anônima é uma função definida diretamente e
sem um nome
<?php
function () { echo 'Hello World'; };

50
● Uma lambda pode ser armazenado em uma variável
<?php
$hello = function () { echo 'Hello World'; };

51
● E depois podem ser usadas como qualquer
executável PHP
<?php
$hello();
call_user_func($hello);

52
● Você também pode passar uma lambda como um
argumento de uma função ou método
<?php
function foo(Closure $func)
{
$func();
}
foo($hello);

53
<?php
$hello = function ($name) { echo 'Hello '.$name; };
$hello('Fabien');
call_user_func($hello, 'Fabien');
function foo(Closure $func, $name)
{
$func($name);
}
foo($hello, 'Fabien');

54
Gerenciando objetos

55
Armazene um lambda
capaz de criar objetos
sob demanda
Notifique a closure
para criar um objeto
passando um Container
class Container
{
  protected $objects = array();
  public function __set($key, $value)
  {
  }
  public function __get($key)
  {
  }
  public function setService($key, Closure $service)
  {
    $this>objects[$key] = $service;
  }
  public function getService($key)
  {
    return $this>objects[$key]($this);
  }
}

56
<?php
$container>setService('user', function ($c)
{
return new User($c>getService('storage'));
});
$container>setService('storage', function ($c)
{
return new $c>storage_class($c>session_name);
});
<?php
$user = $container>getService('user');

57
Simplificando o código

58
<?php
class Container
{
  protected $values = array();
  function __set($id, $value)
  {
    $this>values[$id] = $value;
  }
  function __get($id)
  {
    if (is_callable($this>values[$id]))
    {
      return $this>values[$id]($this);
    }
    else
    {
      return $this>values[$id];
    }
  }
}

59
<?php
$container>user = function ($c)
{
return new User($c>storage);
};
$container>storage = function ($c)
{
return new $c>storage_class($c>session_name);
};
Interface unificada

60
Escopo

61
● Para alguns tipos de objetos, como o Usuário, o
Container sempre deve retornar a mesma instância
<?php
spl_object_hash($container>user) !== spl_object_hash($container>user);

62
<?php
$container>user = function ($c)
{
  static $user;
  if (is_null($user))
  {
    $user = new User($c>storage);
  }
  return $user;
};

63
<?php
spl_object_hash($container>user) === spl_object_hash($container>user);

64
<?php
$container>user = $container>asShared(function ($c)
{
});

65
Uma Closure é uma lambda que lembra seu
estado durante sua criação

66
<?php
class Article
{
  public function __construct($title)
  {
    $this>title = $title;
  }
  public function getTitle()
  {
    return $this>title;
  }
}
$articles = array(
  new Article('Title 1'),
  new Article('Title 2'),
);

67
<?php
$mapper = function ($article)
{
return $article>getTitle();
};
$titles = array_map($mapper, $articles);

68
<?php
$method = 'getTitle';
$mapper = function ($article) use($method)
{
return $article>$method();
};
$method = 'getAuthor';
$titles = array_map($mapper, $articles);

69
<?php
$mapper = function ($method)
{
  return function ($article) use ($method)
  {
    return $article>$method();
  };
};

70
<?php
$titles = array_map($mapper('getTitle'), $articles);
$authors = array_map($mapper('getAuthor'), $articles);

71
<?php
$container>user = $container>asShared(function ($c)
{
});

72
<?php
function asShared(Closure $lambda)
{
  return function ($container) use ($lambda)
  {
    static $object;
    if (is_null($object))
    {
      $object = $lambda($container);
    }
    return $object;
  };
}

73
Gerenciamento
de erros
class Container
{
  protected $values = array();
  function __set($id, $value) {
    $this>values[$id] = $value;
  }
  function __get($id) {
    if ( ! isset($this>values[$id])) {
      throw new InvalidArgumentException(sprintf('Value "%s" is not defined.', $id));
    }
    if (is_callable($this>values[$id])) {
      return $this>values[$id]($this);
    } else {
      return $this>values[$id];
    }
  }
  function asShared($callable) {
    return function ($c) use ($callable) {
      static $object;
      if (is_null($object)) {
        $object = $callable($c);
      }
      return $object;
    };
  }
}

74
NÃO estou afirmando para usarem lambdas em
todos os lugares
Esta apresentação tem o intuito de mostrar como
elas funcionam em exemplos práticos

75
Um DI Container NÃO gerencia
TODOS seus objetos

76
Boa regra para lembrar:
Ele gerencia objetos “globais”
Objetos com somente uma instância (!=
singleton)

77
COMO
Um Usuário, uma Requisição (Request), um
Logger, uma conexão com a Base de Dados, ...

78
E NÃO COMO
Objetos de Modelo (um Blog, um Produto, ...)

79
Lembre-se: Na maioria das vezes,
você não precisa de um Container para usar
Dependency Injection

80
Você pode começar a usar e se beneficiar de
Dependency Injection hoje

81
Implementando uma no seu projeto
Usando bibliotecas externas que já utilizam DI
sem precisa de um Container

82
Symfony
Zend Framework
Doctrine
ezComponents
Swift Mailer
...

83
● Symfony Components DependencyInjection
● Usado no core do Symfony 2 (uma das mais rápidas
frameworks)
● Flexível (YAML, XML, INI and PHP)

Dependency injection

Mais conteúdo relacionado

Mais procurados

Semelhante a Dependency injection

Mais de Guilherme Blanco

Dependency injection