介紹一個基于 .NET 的船新 PHP SDK + Runtime: PeachPie
前言#
這幾天想基于 .NET Core 搞一個自己的部落格網站,于是在網上搜刮各種部落格引擎,找到了這些候選:Blogifier、Miniblog 以及 edi 寫的 Moonglate。
Blogifier:這是前端是個 Angular SPA 應用,不利于 SEO,同時首屏加載速度慢,是以排除。
Miniblog:顧名思義 Mini,可以完美承載内容但是主題實在是過于簡單,沒有可自定義性,是以排除。
Moonglate:總體感覺不錯,界面設計得也很好,功能全面,然而需要 SQL Server 作為資料庫,然而 SQL Server 雖然有 Linux 版本,但受限于主機配置和預算是以也被排除。
難道就沒有适合我需求的部落格引擎了嗎?答案當然是:有。
衆所周知 PHP 是世界上最好的語言(滑稽),還是衆所周知有一個叫做 WordPress 的部落格引擎生态非常龐大,而且是使用 PHP 建構的。
可是 PHP 和 .NET 又有什麼關系呢?
PeachPie#
PeachPie 是一個完全建構于 .NET Standard 之上的一套完整的 PHP SDK + Runtime,包含編譯器和運作時等等,相容 PHP 5.4-7.4(當然部分功能仍在開發中)。
官網:
https://www.peachpie.io那麼 PeachPie 有什麼優點呢:
開源:
https://github.com/peachpiecompiler/peachpie跨平台:因為 PeachPie 完全建構于 .NET 之上,是以也就跟着跨平台了,Windows、MacOS、Linux 等等,從架構上跨 x86、x86_64、ARM、ARM64,未來甚至還會有 MIPS、MIPS64、Risc-V 等等......
純托管代碼:借助 VS 強大的調試器和 IDE 體驗,從開發、調試到測試、Profile 一條龍非常爽
編譯:PHP 是沒有編譯之說的,這門動态類型語言和 Python 面臨一樣的問題,幾乎無法在編譯時發現代碼中的錯誤,即便借助 linter 診斷出了文法錯誤也很難診斷出類型的錯誤。而 PeachPie 則有完善的編譯器套件将 PHP 代碼完整的編譯為 .NET Standard 程式集,意味着在編譯期就做好了文法和類型檢查,保證了運作時不會因為代碼問題導緻程式崩潰,同時應用分發的時候也不需要源代碼,確定了源碼安全
與 .NET 互操作:PeachPie 在保留了 PHP 原本的生态基礎上做到了 PHP 和 .NET 的互操作,一個 PeachPie 項目不但可以使用 PHP 原有生态中的包和插件,還能享受 .NET 的生态,快樂超級加倍
運作在 .NET 上:CLR/CoreCLR 自帶久經考驗的 JIT 和 GC,是以通過 PeachPie 編譯的程式集運作在 CLR/CoreCLR 之上則無需做任何的代碼改動即可享受到這些東西,在 php-bench 中,借助 CoreCLR 平台的 JIT,函數調用性能拉開了原來 PHP 幾個數量級
.NET Foundation 項目:背後有 .NET Foundation 支援,瓦利亞高品質,有保證
可是有人就要問了,為什麼我不直接用 PHP 而是選用 PeachPie 曲線救國呢?
因為我樂意,雨女無瓜(逃
開始使用#
本文開發環境采用 Visual Studio Code(需要安裝 PeachPie 插件),當然你也可以用 Visual Studio 等其他開發工具。
安裝 PeachPie 最新的項目模闆:
Copy
dotnet new -i Peachpie.Templates::*
然後就會出現三個新的項目模闆:Console Application、Class library 和 ASP.NET Core Empty。
我們這次整個 Console Application 看看。
dotnet new console -lang PHP
然後随便寫點代碼:
<?php
function main()
{
$students =
array(
array("first_name" => "Joe", "score" => 83, "last_name" => "Smith"),
array("first_name" => "Frank", "score" => 92, "last_name" => "Barbson"),
array("first_name" => "Benji", "score" => 90, "last_name" => "Warner")
);
foreach ($students as $value) {
echo $value["first_name"], " ", $value["last_name"], "'s score is ", $value["score"], "\n";
}
}
main();
用配置 .NET Core 項目的方式寫好 Visual Studio Code 需要的 tasks.json 和 launch.json,随便下點斷點然後編譯 + F5 運作!
編譯輸出(請無視掉我的霓虹語電腦環境):
.NET Core 向け Microsoft (R) Build Engine バージョン 16.7.0-preview-20220-01+80e487bff
Copyright (C) Microsoft Corporation.All rights reserved.
復元対象のプロジェクトを決定しています...
復元対象のすべてのプロジェクトは最新です。
プレビュー版の .NET Core を使用しています。
https://aka.ms/dotnet-core-previewをご覧ください
PeachPie PHP Compiler version 0.9.981+565af85b9aafc42fe1af2f30ccd73ff093a2fad7
PeachPieConsole -> C:Usershez20sourcereposPeachPieConsolebinDebugnetcoreapp3.1PeachPieConsole.dll
ビルドに成功しました。
0 個の警告
0 エラー
経過時間 00:00:12.98
Voila!
輸出:
Joe Smith's score is 83
Frank Barbson's score is 92
Benji Warner's score is 90
如果去掉打錯一個變量 $value 變成 $vuale 會怎麼樣呢?
$students =
array(
array("first_name" => "Joe", "score" => 83, "last_name" => "Smith"),
array("first_name" => "Frank", "score" => 92, "last_name" => "Barbson"),
array("first_name" => "Benji", "score" => 90, "last_name" => "Warner")
);
foreach ($students as $value) {
echo $vuale["first_name"], " ", $value["last_name"], "'s score is ", $value["score"], "\n";
}
編譯輸出:
program.php(13,14): warning PHP5007: Undefined variable: $vuale [C:Usershez20sourcereposPeachPieConsolePeachPieConsole.msbuildproj]
program.php(13,14): warning PHP5007: Undefined variable: $vuale [C:Usershez20sourcereposPeachPieConsolePeachPieConsole.msbuildproj]
1 個の警告
0 エラー
経過時間 00:00:09.51
由于上述代碼在 PHP 中是合法代碼,是以為了保持相容性,PeachPie 不會報錯而是給了警告。
但如果我們少一個分号呢:
$students =
array(
array("first_name" => "Joe", "score" => 83, "last_name" => "Smith"),
array("first_name" => "Frank", "score" => 92, "last_name" => "Barbson"),
array("first_name" => "Benji", "score" => 90, "last_name" => "Warner")
)
foreach ($students as $value) {
echo $value["first_name"], " ", $value["last_name"], "'s score is ", $value["score"], "\n";
}
program.php(12,5): error PHP2014: Syntax error: unexpected token 'foreach' [C:Usershez20sourcereposPeachPieConsolePeachPieConsole.msbuildproj]
ビルドに失敗しました。
0 個の警告
1 エラー
経過時間 00:00:01.77
這次就會直接報錯了。
由此可見,使用 PeachPie 能夠無需第三方工具輔助,直接在編譯時就驗證代碼正确性,對項目的健壯性有很大幫助。
PHP 與 .NET 互操作#
我們試試互操作,在 PHP 裡面建立一個 .NET 中的 HashSet:
$list = new System\Collections\Generic\HashSet<string>;
$list->Add("test");
$list->Add("hello");
$list->Add("hello");
$list->Add("lol");
foreach ($list as $key => $value) {
echo $key, ": ", $value, "\n";
}
0: test
1: hello
2: lol
完美,另外,鑒于 PHP 代碼最後都會被編譯成 .NET Standard 程式集,是以反過來當然也沒問題,就不做介紹了。
一些坑#
當然,PeachPie 現在還處于比較早期階段,盡管大多數 PHP 代碼都能正常運作,但是标準庫仍存在一些相容性問題,具體可以去這裡跟蹤:
https://docs.peachpie.io/compatibility-status。
也正是因為還是處于早期狀态,是以很多優化工作(比如數組的優化)都沒有做,性能方面還有很大的提升空間。
不過官方目前開發進度十分快,是以短時間内就能看到大量的新庫函數被實作,到目前已經是 0.9.800,1.0 正式版也快要釋出了,很快就能正式投入生産使用啦。
Blog 搭建#
回到前面的主題,有了 PeachPie,我就能把 WordPress 放到 .NET Core 上面跑啦。
當然,直接下載下傳下來 WordPress 的源代碼編譯跑到 ASP.NET Core 上面時會出現一些問題,比如資源加載全部 404,這是因為 PeachPie 在編譯 PHP 代碼時預設不會将非 .php 的檔案包含到編譯過程中,我們需要修改 .msbuildproj 調整項目屬性将資源檔案包含在編譯過程中,并作為 Content 引入。
另外由于 WordPress 首次配置會現場生成一個 config.php 檔案,但是由于該檔案是編譯後的程式集在運作時生成的,未參與編譯過程,是以運作時是找不到這個類的,除非重新編譯一遍。是以我們想采用更清真的方式,直接在 appsettings.json 裡面寫入配置然後運作時讀入代替原來的 config.php。
總之需要經過一系列操作,并且編寫少量代碼。不過,PeachPie 已經幫我們做好了這一切:iolevel 提供了一個即插即用的 WordPress 包 PeachPied.WordPress.AspNetCore(
https://github.com/iolevel/wpdotnet-sdk),可直接作為 ASP.NET Core 中間件使用,非常友善。
那麼事情就簡單了:
dotnet new web
dotnet add package PeachPied.WordPress.AspNetCore --version 1.0.0-*
然後編寫少量服務端代碼,配置一下 https 跳轉、響應壓縮和靜态檔案什麼的,再加入 WordPress 中間件:
Startup.cs
using System.Linq;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.ResponseCompression;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
namespace KeBlogs
public class Startup
{
// This method gets called by the runtime. Use this method to add services to the container.
// For more information on how to configure your application, visit https://go.microsoft.com/fwlink/?LinkID=398940
public void ConfigureServices(IServiceCollection services)
{
services.AddResponseCompression(options =>
{
options.Providers.Add<BrotliCompressionProvider>();
options.Providers.Add<GzipCompressionProvider>();
options.MimeTypes = ResponseCompressionDefaults.MimeTypes.Concat(new[] {
"image/svg+xml",
"image/png",
"font/woff",
"font/woff2",
"font/ttf",
"font/eof",
"image/x-icon",
"application/json",
"application/octet-stream" });
});
}
// This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
app.UseHttpsRedirection();
app.UseResponseCompression();
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}
app.UseDefaultFiles();
app.UseStaticFiles();
app.UseWordPress();
}
}
代碼部分搞定,當然上述代碼你也可以用 PHP 來寫。
然後在 appsettings.json 寫入自己的配置,比如(SALT 部分可以沒有):
"WordPress": {
"dbhost": "localhost",
"dbpassword": "password",
"dbuser": "root",
"dbname": "wordpress",
"dbTablePrefix": "wp_",
"SALT": {
"AUTH_KEY": "r(EoMbKEvlg){+!T42fh-e+~IGj-4q}g8HHB9hjbiC0J*ySU1Y*3z[3c}F;6=TA5",
"AUTH_SALT": "q0#AzvJ*[4~Bexa9*M(sC_#pDuGQBdjL1}j*RilSe0ku]P~KuTir[7PxjE:4)_zR",
"LOGGED_IN_KEY": "!AAienFSridCUzF(v}m#}_;+t%Rclg;mOPKwe;w7dN0M{d,]?8V+TRW_UG)tSswa",
"LOGGED_IN_SALT": "C=(4(8WPMeRu_h?g7!ddI*P:+SYU=3C%g)92oV}-y5tE0r?DHWl!fjPOp=bjx2YJ",
"NONCE_KEY": "Z[e37@=y)m.CHa:OSldh#RT@nIZxKYGwu!/hd:vK#^{_Ec7e{KNb(G.8ch/MkH(d",
"NONCE_SALT": ";v7Wv/BV)Pz{W,FaAKC0buH*5U4:g]qn~;b94x]f8=lm6!yyYSbW5*2y*kRXXEF5",
"SECURE_AUTH_KEY": "pc}_Pv52,m=j9l#llSkLVQib.Zm!;9FRzg:{(G]tM8}[}]pPDwB4k{xV+!e)9lmR",
"SECURE_AUTH_SALT": "#n]+o^w/%-~MVzf{AUuxUAwF[n03r{kr^r1V?wqQ?Vjt}!0HSkCB-):u-ra1%tB="
},
"constants": {
}
然後釋出我們的 WordPress!
dotnet publish -c Release
最後打包 bin/Release/netcoreapp3.1/publish 上傳到伺服器上面,搭建好資料庫然後運作即可。
完結撒花#
進入管理面闆,大多數主題、插件都能正常工作,安裝點主題,配置配置插件和 SMTP,就全部搞定啦。
記憶體占用 195 MB,運作在 .NET Core 3.1.3 上,非常清真!
至此我的 Blog 搭建完成,歡迎大家通路:
https://hez2010.com評論和注冊什麼的也開放了,歡迎大家常光臨~
後續我也會不斷在上面更新文章,當然,這個 Blog 上面的内容也就不僅限于程式設計啦,敬請期待~
完結撒花~
作者: hez2010
出處:
https://www.cnblogs.com/hez2010/p/12878619.html