👩‍🔬 🎒 🤘 SSR: renderização de um aplicativo ReactJS no back-end usando PHP 💼 👨🏾‍💼 🕺🏿

Nossa tarefa era implementar um construtor de sites. Na frente, tudo é executado por um aplicativo React que, a partir das ações do usuário, gera JSON com informações de como construir HTML e o armazena no backend do PHP. Em vez de duplicar a lógica de montagem HTML no back-end, decidimos reutilizar o código JS. Obviamente, isso simplificará a manutenção, já que o código só será alterado em um lugar por uma pessoa. Aqui, a renderização do lado do servidor vem ao resgate junto com o mecanismo V8 e a extensão PHP V8JS.

Neste artigo, vamos cobrir como usamos V8Js para nossa tarefa específica, mas os casos de uso não se limitam apenas a isso. A mais óbvia é a capacidade de usar a renderização do lado do servidor para atender às suas necessidades de SEO.

Configurando

Usamos Symfony e Docker, então a primeira etapa é inicializar um projeto vazio e configurar o ambiente. Vamos observar os pontos principais:

A extensão V8Js deve ser instalada no Dockerfile:

...
RUN apt-get install -y software-properties-common
RUN add-apt-repository ppa:stesie/libv8 && apt-get update
RUN apt-get install -y libv8-7.5 libv8-7.5-dev g++ expect
RUN git clone https://github.com/phpv8/v8js.git /usr/local/src/v8js && \
   cd /usr/local/src/v8js && phpize && ./configure --with-v8js=/opt/libv8-7.5 && \
   export NO_INTERACTION=1 && make all -j4 && make test install

RUN echo extension=v8js.so > /etc/php/7.2/fpm/conf.d/99-v8js.ini
RUN echo extension=v8js.so > /etc/php/7.2/cli/conf.d/99-v8js.ini
...

Instalando React e ReactDOM da maneira mais fácil

Adicionar rota de índice e controlador padrão:

<?php
declare(strict_types=1);

namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Annotation\Route;

final class DefaultController extends AbstractController
{
   /**
    * @Route(path="/")
    */
   public function index(): Response
   {
       return $this->render('index.html.twig');
   }
}

Adicione o modelo index.html.twig com React incluído

<html>
<body>
    <div id="app"></div>
    <script src="{{ asset('assets/react.js') }}"></script>
    <script src="{{ asset('assets/react-dom.js') }}"></script>
    <script src="{{ asset('assets/babel.js') }}"></script>
    <script type="text/babel" src="{{ asset('assets/front.jsx') }}"></script>
</body>
</html>

Usando

Para demonstrar a V8, vamos criar um script de renderização H1 e P simples com o texto assets / front.jsx:

'use strict';

class DataItem extends React.Component {
   constructor(props) {
       super(props);

       this.state = {
           checked: props.name,
           names: ['h1', 'p']
       };

       this.change = this.change.bind(this);
       this.changeText = this.changeText.bind(this);
   }

   render() {
       return (
           <li>
               <select value={this.state.checked} onChange={this.change} >
                   {
                       this.state.names.map((name, k) => {
                           return (
                               <option key={k} value={name}>{name}</option>
                           );
                       })
                   }
               </select>
               <input type='text' value={this.state.value} onChange={this.changeText} />
           </li>
       );
   }

   change(e) {
       let newval = e.target.value;
       if (this.props.onChange) {
           this.props.onChange(this.props.number, newval)
       }
       this.setState({checked: newval});
   }

   changeText(e) {
       let newval = e.target.value;
       if (this.props.onChangeText) {
           this.props.onChangeText(this.props.number, newval)
       }
   }
}

class DataList extends React.Component {
   constructor(props) {
       super(props);
       this.state = {
           message: null,
           items: []
       };

       this.add = this.add.bind(this);
       this.save = this.save.bind(this);
       this.updateItem = this.updateItem.bind(this);
       this.updateItemText = this.updateItemText.bind(this);
   }

   render() {
       return (
           <div>
               {this.state.message ? this.state.message : ''}
               <ul>
                   {
                       this.state.items.map((item, i) => {
                           return (
                               <DataItem
                                   key={i}
                                   number={i}
                                   value={item.name}
                                   onChange={this.updateItem}
                                   onChangeText={this.updateItemText}
                               />
                           );
                       })
                   }
               </ul>
               <button onClick={this.add}></button>
               <button onClick={this.save}></button>
           </div>
       );
   }

   add() {
       let items = this.state.items;
       items.push({
           name: 'h1',
           value: ''
       });

       this.setState({message: null, items: items});
   }

   save() {
       fetch(
           '/save',
           {
               method: 'POST',
               headers: {
                   'Content-Type': 'application/json;charset=utf-8'
               },
               body: JSON.stringify({
                   items: this.state.items
               })
           }
       ).then(r => r.json()).then(r => {
           this.setState({
               message: r.id,
               items: []
           })
       });
   }

   updateItem(k, v) {
       let items = this.state.items;
       items[k].name = v;

       this.setState({items: items});
   }

   updateItemText(k, v) {
       let items = this.state.items;
       items[k].value = v;

       this.setState({items: items});
   }
}

const domContainer = document.querySelector('#app');
ReactDOM.render(React.createElement(DataList), domContainer);

Acesse localhost: 8088 (8088 é especificado em docker-compose.yml como porta nginx):

create table data(
   id serial not null primary key,
   data json not null
);

Rota

/**
* @Route(path="/save")
*/
public function save(Request $request): Response
{
   $em = $this->getDoctrine()->getManager();

   $data = (new Data())->setData(json_decode($request->getContent(), true));
   $em->persist($data);
   $em->flush();

   return new JsonResponse(['id' => $data->getId()]);
}

Clique no botão salvar, ao clicar em nossa rota, JSON é enviado:

{
  "items":[
     {
        "name":"h1",
        "value":" "
     },
     {
        "name":"p",
        "value":" "
     },
     {
        "name":"h1",
        "value":"  "
     },
     {
        "name":"p",
        "value":"   "
     }
  ]
}

Em resposta, o identificador do registro no banco de dados é retornado:

/**
* @Route(path="/save")
*/
public function save(Request $request): Response
{
   $em = $this->getDoctrine()->getManager();

   $data = (new Data())->setData(json_decode($request->getContent(), true));
   $em->persist($data);
   $em->flush();

   return new JsonResponse(['id' => $data->getId()]);
}

Agora que você tem alguns dados de teste, pode experimentar o V8 em ação. Para fazer isso, você precisará esboçar um script React que formará componentes dos adereços Dom passados. Vamos colocá-lo ao lado de outros ativos e chamá-lo de ssr.js:

'use strict';

class Render extends React.Component {
   constructor(props) {
       super(props);
   }

   render() {
       return React.createElement(
           'div',
           {},
           this.props.items.map((item, k) => {
               return React.createElement(item.name, {}, item.value);
           })
       );
   }
}

Para formar uma string a partir da árvore DOM gerada, usaremos o componente ReactDomServer (https://unpkg.com/browse/react-dom@16.13.0/umd/react-dom-server.browser.production.min.js). Vamos escrever uma rota com HTML pronto:


/**
* @Route(path="/publish/{id}")
*/
public function renderPage(int $id): Response
{
   $data = $this->getDoctrine()->getManager()->find(Data::class, $id);

   if (!$data) {
       return new Response('<h1>Page not found</h1>', Response::HTTP_NOT_FOUND);
   }

   $engine = new \V8Js();

   ob_start();
   $engine->executeString($this->createJsString($data));

   return new Response(ob_get_clean());
}

private function createJsString(Data $data): string
{
   $props = json_encode($data->getData());
   $bundle = $this->getRenderString();

   return <<<JS
var global = global || this, self = self || this, window = window || this;
$bundle;
print(ReactDOMServer.renderToString(React.createElement(Render, $props)));
JS;
}

private function getRenderString(): string
{
   return
       sprintf(
           "%s\n%s\n%s\n%s",
           file_get_contents($this->reactPath, true),
           file_get_contents($this->domPath, true),
           file_get_contents($this->domServerPath, true),
           file_get_contents($this->ssrPath, true)
       );
}

Aqui:

reactPath - caminho para react.js
domPath - caminho para react-dom.js
domServerPath - caminho para react-dom-server.js
ssrPath - o caminho para o nosso script ssr.js

Siga o link / publish / 3:

Como você pode ver, tudo foi renderizado exatamente como precisamos.

Conclusão

Concluindo, gostaria de dizer que a renderização do lado do servidor não é tão difícil e pode ser muito útil. A única coisa que vale a pena adicionar aqui é que a renderização pode levar muito tempo, e é melhor adicionar uma fila aqui - RabbitMQ ou Gearman.

O código-fonte do PPS pode ser visto aqui https://github.com/damir-in/ssr-php-symfony

Autores

damir_in zinvapel

SSR: renderização de um aplicativo ReactJS no back-end usando PHP

Configurando

Usando

Conclusão

More articles: