build: Add PHP binding

.github/workflows/test-all.yaml

@@ -32,6 +32,9 @@ jobs:
       os: ${{ matrix.os }}
       target_option: ${{ matrix.target_option }}
 
+  test-php:
+    uses: ./.github/workflows/test-php.yaml
+
   test-python:
     uses: ./.github/workflows/test-python.yaml
 

.github/workflows/test-php.yaml

@@ -0,0 +1,45 @@
+name: test-php
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    paths:
+      - "prql-php/**"
+      - ".github/workflows/test-php.yaml"
+  workflow_call:
+
+concurrency:
+  # See notes in `pull-request.yaml`
+  group: ${{ github.workflow }}-${{ github.ref }}-php
+  cancel-in-progress: true
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest]
+    steps:
+      - name: 📂 Checkout code
+        uses: actions/checkout@v3
+      - uses: actions-rs/toolchain@v1
+        with:
+          toolchain: stable
+      - run: cargo build
+        working-directory: prql-lib
+      - run: |
+          mv ../target/debug/libprql_lib.so ../prql-php/src/libprql_lib.so
+          ls -l ../target/debug/
+          uname -a
+          ls -lR ../prql-php/
+        working-directory: prql-lib
+      - name: 📦 Install dependencies using Composer
+        uses: php-actions/composer@v6
+        with:
+          args: --working-dir=prql-php
+          php_extensions: FFI
+      - name: 🧪 Run tests using PHPUnit
+        run: vendor/bin/phpunit tests
+        working-directory: prql-php

book/src/bindings/README.md

@@ -4,6 +4,7 @@ PRQL has bindings for many languages. These include:
 
 - [Java](./java.md)
 - [JavaScript](./javascript.md)
+- [PHP](./php.md)
 - [Python](./python.md)
 - [R](./r.md)
 - [Rust](./rust.md)

book/src/bindings/php.md

@@ -0,0 +1 @@
+{{#include ../../../prql-php/README.md}}

prql-php/.gitignore

@@ -0,0 +1 @@
+/vendor

prql-php/README.md

@@ -0,0 +1,25 @@
+# prql-php
+
+`prql-php` offers PHP bindings through FFI.
+
+It provides the `Compiler` class which contains the `toJson` and `toSql`
+methods.
+
+It's still at an early stage, and isn't published to Composer. Contributions are
+welcome.
+
+## Installation
+
+The [PHP FFI extension](https://www.php.net/manual/en/book.ffi.php) needs to be
+enabled. Set `ffi.enable` in your php.ini configuration file to `"true"`.
+
+## Usage
+
+```php
+<?php
+
+use Prql\Compiler\Compiler;
+
+$prql = new Compiler();
+$result = $prql->toSql("from employees");
+```

prql-php/composer.json

@@ -0,0 +1,37 @@
+{
+  "name": "prql/compiler",
+  "description": "PRQL compiler bindings.",
+  "keywords": [
+    "prql",
+    "sql"
+  ],
+  "homepage": "https://prql-lang.org/",
+  "type": "library",
+  "license": "Apache-2.0",
+  "autoload": {
+    "psr-4": {
+      "Prql\\Compiler\\": "src/"
+    }
+  },
+  "autoload-dev": {
+    "psr-4": {
+      "Prql\\Tests\\": "tests/"
+    }
+  },
+  "authors": [
+    {
+      "name": "Jonathan"
+    }
+  ],
+  "support": {
+    "issues": "https://github.com/PRQL/prql/issues",
+    "source": "https://github.com/PRQL/prql",
+    "docs": "https://prql-lang.org/book/"
+  },
+  "require": {
+    "ext-ffi": "*"
+  },
+  "require-dev": {
+    "phpunit/phpunit": "^10"
+  }
+}