diff --git a/docs/meson.build b/docs/meson.build
index b77b3e5e33..6effe4f838 100644
--- a/docs/meson.build
+++ b/docs/meson.build
@@ -30,7 +30,6 @@ docs_html_in_files = [
'formatstoragecaps',
'index',
'internals',
- 'php',
'python',
'remote',
'storage',
@@ -100,6 +99,7 @@ docs_rst_files = [
'nss',
'pci-addresses',
'pci-hotplug',
+ 'php',
'platforms',
'programming-languages',
'securityprocess',
diff --git a/docs/php.html.in b/docs/php.html.in
deleted file mode 100644
index 9340c81eec..0000000000
--- a/docs/php.html.in
+++ /dev/null
@@ -1,28 +0,0 @@
-
-
-
-
- PHP API bindings
-
-Presentation
- The libvirt-php, originally called php-libvirt, is the PHP API bindings for
- the libvirt virtualization toolkit originally developed by Radek Hladik.
-
-Getting the source
- The PHP bindings code source is now maintained in a git repository available on
-gitlab.com:
-
-
-git clone https://gitlab.com/libvirt/libvirt-php.git
-
-
-
-Project pages
-Since February 2011 the project has its own pages hosted at libvirt.org. For more information on the project
- please refer to https://libvirt.org/php.
-
-
-
-
-
diff --git a/docs/php.rst b/docs/php.rst
new file mode 100644
index 0000000000..36f7c44bed
--- /dev/null
+++ b/docs/php.rst
@@ -0,0 +1,23 @@
+================
+PHP API bindings
+================
+
+The libvirt-php, originally called php-libvirt, is the PHP API bindings for the
+libvirt virtualization toolkit originally developed by Radek Hladik.
+
+Getting the source
+------------------
+
+The PHP bindings code source is now maintained in a
+`git `__ repository available on
+`gitlab.com `__:
+
+::
+
+ git clone https://gitlab.com/libvirt/libvirt-php.git
+
+Project pages
+-------------
+
+Since February 2011 the project has its own pages hosted at libvirt.org. For
+more information on the project please refer to https://libvirt.org/php.