Secciones

Enlace HTML (PSR-13)


Resumen

Phalcon\Html\Link\EvolvableLink, Phalcon\Html\Link\EvolvableLinkProvider, Phalcon\Html\Link\Link y Phalcon\Html\Link\LinkProvider son clases que implementan las interfaces definidas por PHP-FIG.

Estos componentes ayudan a crear objetos Link según el estándar definido por PSR-13.

NOTA: Este componente no genera ningún enlace HTML. Sólo almacena los enlaces y ofrece métodos definidos según el estándar PSR-13. Necesitará crear sus propios serializadores que analizarán estos objetos y generarán la salida necesaria. Se puede usar el serializador Phalcon\Html\Link\Serializer\Header.

Phalcon\Html\Link\Link se usa para crear un enlace y asignarle atributos durante su construcción.

<?php

use Phalcon\Html\Link\Link;

$href       = 'https://dev.phalcon.ld';
$attributes = [
    'one'   => true,
    'two'   => 123,
    'three' => 'four',
    'five'  => [
        'six',
        'seven',
    ],
];

$link = new Link('payment', $href, $attributes);

LinkProvider

Phalcon\Html\Link\LinkProvider se usa como contenedor de objetos Phalcon\Html\Link\Link. Puede añadirlos al proveedor y luego acceder a ellos en su conjunto o recuperarlos mediante rel.

<?php

use Phalcon\Html\Link\Link;
use Phalcon\Html\Link\LinkProvider;

$links = [
    new Link('canonical', 'https://dev.phalcon.ld'),
    new Link('cite-as', 'https://test.phalcon.ld'),
];
$link  = new LinkProvider($links);


var_dump(
    $link->getLinksByRel('cite-as')
);

// [
//     Link('cite-as', 'https://test.phalcon.ld'),
// ]

Los objetos enlace son inmutables. Sin embargo, hay necesidad de manipularlos en función de las necesidades de su aplicación. Phalcon\Html\Link\EvolvableLink está disponible, permitiéndole manipular el enlace.

<?php

use Phalcon\Html\Link\EvolvableLink;

$href       = 'https://dev.phalcon.ld';
$attributes = ['one' => true];

$link = new EvolvableLink('payment', $href, $attributes);

$newInstance = $link->withAttribute('two', 'three');

var_dump(
    $newInstance->getAttributes()
);

//  [
//      'one' => true,
//      'two' => 'three',
//  ];

EvolvableLinkProvider

Phalcon\Html\Link\LinkProvider se usa como contenedor de objetos Phalcon\Html\Link\EvolvableLink. Puede añadirlos al proveedor y luego acceder a ellos en su conjunto o recuperarlos mediante rel.

<?php

use Phalcon\Html\Link\EvolvableLink;
use Phalcon\Html\Link\EvolvableLinkProvider;

$links = [
    new Link('canonical', 'https://dev.phalcon.ld'),
    new Link('cite-as', 'https://test.phalcon.ld'),
];
$link  = new EvolvableLinkProvider($links);


var_dump(
    $link->getLinksByRel('cite-as')
);

// [
//     Link('cite-as', 'https://test.phalcon.ld'),
// ]

Serializadores

Puede usar un serializador para analizar los objetos Phalcon\Html\Links y crear las cabeceras necesarias. Phalcon viene con el serializador Phalcon\Html\Link\Serializer\Header, para ayudar con la tarea de serializar enlaces para las cabeceras:

<?php

use Phalcon\Html\Link\EvolvableLink;
use Phalcon\Html\Link\Serializer\Header;

$serializer = new Header();

$link = new EvolvableLink('prefetch', '/images/apple-icon-114.png');

echo $serializer->serialize([$link]);
// </images/apple-icon-114.png>; rel="prefetch"';


$links = [
    (new EvolvableLink('preload', '/1'))
        ->withAttribute('as', 'image')
        ->withAttribute('nopush', true),
    (new EvolvableLink('alternate', '/2'))
        ->withRel('next')
        ->withAttribute('hreflang', ['en', 'es'])
];

echo $serializer->serialize([$link]);
// </1>; rel="preload"; as="image"; nopush,
//     </2>; rel="alternate next"; hreflang="en"; hreflang="es"
;

Personalizado

Puede crear sus propios serializadores relevantes para enlaces extendiendo Phalcon\Html\Link\Serializer\SerializerInterface

<?php

namespace MyApp\Html\Serializers;

use Phalcon\Html\Link\Serializer\SerializerInterface;

class Custom implements SerializerInterface 
{
    public function serialize(array $links): ?string
    {
        // ....
    }
}