Blazor plus Peachpie

PHP as a client side language

The documentation is in progress. You can use ./docs/NeedsToBeChange/thesis.pdf as a source of information about the functionality until the new documentation is not created. However, the text is not actual, and new changes are not presented there.

What is it?

This repository contains Peachpie.Blazor library and Peachpie.Blazor.Sdk to enable making websites with PHP together with Blazor on a client side. With these components, you can write just PHP scripts, which are transparently navigated and managed.

You can see the usage demonstration below.

Why is it useful?

There are potential scenarios of usage:

• You want to move a PHP website to a client side to save server resources.
• You have a Blazor website and want to write a part of the website in the PHP language.
• You want to use PHP libraries on the client side.
• PHP and Blazor team can work together to make an awesome website using .NET and PHP.

How to get started?

At the time of writing, the blazor templates are not a part of Peachpie.Templates yet. But you can still compile it from ./templates folder by following the instruction inside the folder and then continue here.

You can start right now.

Steps:

1. Install Peachpie.Templates by dotnet new -i "Peachpie.Templates::*"
2. Choose the template based on your intention:
   • blazor-hybrid- A simple PHP website running in browser
   • blazor-web - A simple Blazor website combining PHP and Razor Pages
3. Create the project by dotnet new project-name
4. Add Razor pages to BlazorApp.Client or PHP scripts to PHPScripts (Optional)
5. Launch the Blazor.Server by dotnet run --project BlazorApp\Server
6. Access https://localhost:5001

Features

• Transparent navigation of PHP scripts by URL

• Transparent rendering of HTML pages generated from PHP

• Full support of \_GET, _POST, and $_FILES

• Simulation of a server on a client side

• Forms are handled by PHP on a client side

• Possibility of persistent PHP context to save client session on a client side

• Inserting PHP scripts to Razor pages

• PHP, C#, JavaScript interoperability

Future plans

There is a rough overview of the possible plans for the future:

• Make rendering with the PhpScriptProvider efficient enough in order to remove PhpComponent and make the usage even more transparent.
• Figure out the support for databases.
• Move WordPress to a client side.

Documentation

Detailed information about the solution, the library, and the functionality can be found in docs folders. Advanced features of the integration are shown there. There can be some missing information about any part of the whole project. If you can ask about something, feel free to contact me, and I will add this information to the folder for future interested people.

Release

This is the first version of the integration. The API and functionality might still change to improve the advantages. The sources compilation should work, feel free to contact me (husaktomas98@google.com) to get more information about this project.