varyan/php-based-react-backend-rendering

PHP based composer package to make rect rendering on backend

PHP based react server side rendering

Travis CI build status

, _(*1)

Bifore Installation

Before running composer make sure you have installed V8Js PHP extension, _(*2)

You can find how to install V8Js extension for..., _(*3)

• Windows
  • https://blog.xenokore.com/how-to-install-v8js-for-php-on-windows/
• Linux
  • https://blog.xenokore.com/how-to-install-v8js-for-php-on-linux/

Intallation

• composer require varyan/php-based-react-backend-rendering dev-master

Requirements

• php at less 5.6.24
• reactjs/react-php-v8js

Usage

• copy files and folders from example folder of vendor/varyan/php-based-react-backend-rendering in to your root directory
  • create build folder inside folder where your index.php file located
  • open package.json file
    • if your index.php file inside different folder then your root
      • change build/react-build.min.js > 'folder name where index.php located'/build/react-bundle.min.js
      • change build/app.js > 'folder name where index.php located'/build/app.js
  • In terminal run
    • npm i && npm run make

For MVC systems like..., _(*4)

• Codeigniter, _(*5)

  • file application/config/config.php

      //Add following lines
  
      \VarYans\ReactPHP\Config::setReactSource('path-to/build/react-bundle.min.js');
      \VarYans\ReactPHP\Config::setAppSource('path-to/build/app.js');
  
      //optional you can add error handler for custom error catching
      \VarYans\ReactPHP\Config::setErrorHandler(function(\V8JsException $exception){
          // code coming here
      });
  

  • file application/config/route.php

      //Add following line in your routes list
  
      $route['home/hello'] = "HomeController/Hello";
  
  

  • file application/controllers/HomeController.php

      <?php
  
      use VarYans\ReactPHP\React;
  
      class HomeController extends CI_Controller{
  
          /**
          * @return void
          */
          public function hello(){
              echo React::quickRender("Hello",[
                  "name" => "User"
              ]);
          }
  
           /**
           * if you want to use react component as part of your view 
           * you can write it like this
           * @return \View
           */           
          public function bye(){
              $this->load->view("bye",[
                  "var1"=>"val1",
                  "componentAbout"=>React::quickRender("Bye",[
                      "prop1"=>"val1"
                  ])                    
              ]);
          }
      }
  

• Laravel 5.3 (version mentioned because laravel folders structure are different in different versions), _(*6)

  • file bootstrap/app.php

      //Add following lines
  
      \VarYans\ReactPHP\Config::setReactSource('path-to/build/react-bundle.min.js');
      \VarYans\ReactPHP\Config::setAppSource('path-to/build/app.js');
  
      //optional you can add error handler for custom error catching
      \VarYans\ReactPHP\Config::setErrorHandler(function(\V8JsException $exception){
          // code coming here
      });
  

  • file routes/web.php

      Route::get('/home/hello','HomeController@hello');
      Route::get('/home/bye','HomeController@bye');
  

  • file app/Http/Controllers/HomeController.php

      <?php
  
      namespace App\Http\Controllers;
  
      use VarYans\ReactPHP\React;
  
      class HomeController extends Controller{
  
          /**
          * @return string
          */
          public function hello(){
              return React::quickRender("Hello",[
                  "name" => "User"
              ]);
          }
  
          /**
          * if you want to use react component as part of your view 
          * you can write it like this
          * @return \View
          */
          public function bye(){
              return view('bye',[
                  "var1"=>"val1",
                  "componentAbout"=>React::quickRender("Bye",[
                      "prop1"=>"val1"
                  ])
              ]);
          } 
      }        
  

Versioning

For now you can use only dev-master version, _(*7)

Authors

• Varazdat Stepanyan

License

This project is licensed under the MIT License - see the LICENSE.md file for details, _(*8)