README

Travis CI build status

Bifore Installation

Before running composer make sure you have installed V8Js PHP extension

You can find how to install V8Js extension for...

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...

Codeigniter

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)

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

Authors

Varazdat Stepanyan

License

This project is licensed under the MIT License - see the LICENSE.md file for details

varyan / php-based-react-backend-rendering

Maintainers

Details