前言
这几天想基于 .NET Core 搞一个自己的博客网站,于是在网上搜刮各种博客引擎,找到了这些候选:Blogifier、Miniblog 以及 edi 写的 Moonglade。
Blogifier:这是前端是个 Angular SPA 应用,不利于 SEO,同时首屏加载速度慢,因此排除。
Miniblog:顾名思义 Mini,可以完美承载内容但是主题实在是过于简单,没有可自定义性,因此排除。
Moonglade:总体感觉不错,界面设计得也很好,功能全面,然而需要 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 最新的项目模板:
Copydotnet new -i Peachpie.Templates::*
然后就会出现三个新的项目模板:Console Application、Class library 和 ASP.NET Core Empty。
我们这次整个 Console Application 看看。
Copydotnet new console -lang PHP
然后随便写点代码:
Copy<?phpfunction 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 运行!
编译输出(请无视掉我的霓虹语电脑环境):
Copy.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+565af85b9aafc42fe1af2f30ccd73ff093a2fad7PeachPieConsole -> C:\Users\hez20\source\repos\PeachPieConsole\bin\Debug\netcoreapp3.1\PeachPieConsole.dllビルドに成功しました。0 個の警告0 エラー経過時間 00:00:12.98
Voila!
输出:
CopyJoe Smith's score is 83
Frank Barbson's score is 92
Benji Warner's score is 90
如果去掉打错一个变量 $value
变成 $vuale
会怎么样呢?
Copy<?phpfunction 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 $vuale["first_name"], " ", $value["last_name"], "'s score is ", $value["score"], "\n";}
}main();
编译输出:
Copy.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
program.php(13,14): warning PHP5007: Undefined variable: $vuale [C:\Users\hez20\source\repos\PeachPieConsole\PeachPieConsole.msbuildproj]PeachPieConsole -> C:\Users\hez20\source\repos\PeachPieConsole\bin\Debug\netcoreapp3.1\PeachPieConsole.dllビルドに成功しました。program.php(13,14): warning PHP5007: Undefined variable: $vuale [C:\Users\hez20\source\repos\PeachPieConsole\PeachPieConsole.msbuildproj]1 個の警告0 エラー経過時間 00:00:09.51
由于上述代码在 PHP 中是合法代码,因此为了保持兼容性,PeachPie 不会报错而是给了警告。
但如果我们少一个分号呢:
<?phpfunction 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();
编译输出:
Copy.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
program.php(12,5): error PHP2014: Syntax error: unexpected token 'foreach' [C:\Users\hez20\source\repos\PeachPieConsole\PeachPieConsole.msbuildproj]ビルドに失敗しました。program.php(12,5): error PHP2014: Syntax error: unexpected token 'foreach' [C:\Users\hez20\source\repos\PeachPieConsole\PeachPieConsole.msbuildproj]0 個の警告1 エラー経過時間 00:00:01.77
这次就会直接报错了。
由此可见,使用 PeachPie 能够无需第三方工具辅助,直接在编译时就验证代码正确性,对项目的健壮性有很大帮助。
PHP 与 .NET 互操作#
我们试试互操作,在 PHP 里面创建一个 .NET 中的 HashSet<TValue>
:
<?phpfunction main()
{$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";}
}main();
输出:
Copy0: 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=398940public 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!
Copydotnet publish -c Release
最后打包 bin/Release/netcoreapp3.1/publish 上传到服务器上面,搭建好数据库然后运行即可。
完结撒花#
进入管理面板,大多数主题、插件都能正常工作,安装点主题,配置配置插件和 SMTP,就全部搞定啦。
内存占用 195 MB,运行在 .NET Core 3.1.3 上,非常清真!
至此我的 Blog 搭建完成,欢迎大家访问:https://hez2010.com 。
评论和注册什么的也开放了,欢迎大家常光临~
后续我也会不断在上面更新文章,当然,这个 Blog 上面的内容也就不仅限于编程啦,敬请期待~
从此 PHP 也是 .NET 上的一门语言了,完结撒花~