The whole of WordPress compiled to .NET Core and a NuGet Package with PeachPie

Dev Tips

Why? Because it’s awesome. Sometimes a project comes along that is impossibly ambitious and it works. I’ve blogged a little about Peachpie, the open source PHP compiler that runs PHP under .NET Core. It’s a project hosted at

But…why? Here’s why:

  1. Performance: compiled code is fast and also optimized by the .NET Just-in-Time Compiler for your actual system. Additionally, the .NET performance profiler may be used to resolve bottlenecks.
  2. C# Extensibility: plugin functionality can be implemented in a separate C# project and/or PHP plugins may use .NET libraries.
  3. Sourceless distribution: after the compilation, most of the source files are not needed.
  4. Power of .NET: Peachpie allows the compiled WordPress clone to run in a .NET JIT’ted, secure and manageable environment, updated through windows update.
  5. No need to install PHP: Peachpie is a modern compiler platform and runtime distributed as a dependency to your .NET project. It is downloaded automatically on demand as a NuGet package or it can be even deployed standalone together with the compiled application as its library dependency.

A year ago you could very happily run WordPress (a very NON-trivial PHP application, to be clear) under .NET Core using Peachpie. You would compile your PHP into an assembly and then do something like this in your Startup.cs:

public void Configure(IApplicationBuilder app)

    app.UsePhp(new PhpRequestOptions(scriptAssemblyName: "peachweb"));

And that’s awesome. However, I noticed something on their GitHub recently, specifically under It says:

The solution compiles all of WordPress into a .NET assembly and additionally provides C# wrappers for utilization of compiled sources.

Whoa. Drink that in. The project consists of several parts:

  • wordpress contains sources of WordPress that are compiled into a single .NET Core assembly (wordpress.dll). Together with its content files it is packed into a NuGet package PeachPied.WordPress. The project additionally contains the “must-use” plugin peachpie-api.php which exposes the WordPress API to .NET.
  • PeachPied.WordPress.Sdk defines abstraction layer providing .NET interfaces over PHP WordPress instance. The interface is implemented and provided by peachpie-api.php.
  • PeachPied.WordPress.AspNetCore is an ASP.NET Core request handler that configures the ASP.NET pipeline to pass requests to compiled WordPress scripts. The configuration includes response caching, short URL mapping, various .NET enhancements and the settings of WordPress database.
  • app project is the executable demo ASP.NET Core web server making use of compiled WordPress.

They compiled the whole of WordPress into a NuGet Package.


  • The compiled website runs on .NET Core
  • You’re using ASP.NET Core request handling and you can extend WordPress with C# plugins and themes

Seriously. Go get the .NET Core SDK version 2.1.301 over at and clone their repository locally from

Make sure you have a copy of mySQL running. I get one started FAST with Docker using this command:

docker run --name=mysql1 -p 3306:3306 -e MYSQL_ROOT_PASSWORD=password -e MYSQL_DATABASE=wordpress mysql --default-authentication-plugin=mysql_native_password

Then just “dotnet build” at the root of the project, then go into the app folder and “dotnet run.” It will show up on localhost:5004.

NOTE: I needed to include the default authentication method to prevent the generic WordPress “Cannot establish database connection.” I also added the MYSQL_DATABASE environment variable so I could avoid logging initially using the mysql client and creating the database manually with “CREATE DATABASE wordpress.”

Look at that. I have my mySQL in one terminal listening on 3306, and ASP.NET Core 2.1 running on port 5004 hosting freaking WordPress compiled into a single NuGet package.

Wordpress under .NET Core

Here’s my bin folder:

WordPress as a single DLL

There’s no PHP files which is a nice security bonus – not only are you running from the one assembly but there’s no text files for any rogue plugins to modify or corrupt.

Here’s the ASP.NET Core 2.1 app that hosts it, in full:

using System.IO;
using Microsoft.AspNetCore;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Configuration;
using PeachPied.WordPress.AspNetCore;

namespace peachserver
    class Program
        static void Main(string[] args)
            // make sure cwd is not app but its parent:
            if (Path.GetFileName(Directory.GetCurrentDirectory()) == "app")

            var host = WebHost.CreateDefaultBuilder(args)


    class Startup
        public void Configure(IApplicationBuilder app, IHostingEnvironment env, IConfiguration configuration)
            // settings:
            var wpconfig = new WordPressConfig();

            if (env.IsDevelopment())



I think the app.UseWordPress() is such a nice touch. 😉

I often get emails from .NET developers asking what blog engine they should consider. Today, I think you should look closely at Peachpie and strongly consider running WordPress under .NET Core. It’s a wonderful open source project that brings two fantastic ecosystems together! I’m looking forward to exploring this project more and I’d encourage you to check it out and get involved with Peachpie.

Sponsor: Check out dotMemory Unit, a free unit testing framework for fighting all kinds of memory issues in your code. Extend your unit testing with the functionality of a memory profiler!

Source link

Leave a Reply