PHPC-2435: Support libmongoc 2.0 (#1829)

* Bump libmongoc to 2.0.1 and libmongocrypt to 1.14.0

This fixes the following issues:
* PHPC-2581: Bump to libmongoc 2.0.1
* PHPC-2578: Bump to libmongocrypt 1.14.0
* PHPC-2548: Remove MONGOC_WRITE_CONCERN_W_ERRORS_IGNORED
* PHPC-2540: Use const for mongoc_host_list_t
* PHPC-2547: Remove MONGOC_NO_AUTOMATIC_GLOBALS
* PHPC-2549: Remove BSON_EXTRA_ALIGN
* PHPC-1548: Add tests for empty authSource URI option
* PHPC-2542: Add test coverage for auth mechanism errors

* PHPC-2584: Run driver test with system libraries (#1831)

* Add build action to build libmongoc system libraries

* Build driver with system libs

* Install libmongocrypt as system library

* Run tests with system libs

* Move system library tests to tests workflow

* PHPC-2545: Drop support for compiling with LibreSSL (#1836)

* PHPC-2545: Drop support for compiling with LibreSSL

* Warn when explicitly building with libressl

* Fix usage of wrong version variable

* PHPC-2367: Add SSPI SASL, drop Cyrus on Windows (#1837)

* Support building with SSPI support under Windows

* Remove support for building with Cyrus SASL on Windows

* Apply feedback from Copilot

* Apply code review feedback

* Fix handling of missing SASL libs when relying on default value for with-mongodb-sasl

* Apply feedback from code review

Author: alcaeus

.evergreen/compile-unix.sh

@@ -72,11 +72,6 @@ if [ -n "$LIBMONGOC_VERSION" ]; then
    echo "Finding Python3 binary... done."
 
    php scripts/update-submodule-sources.php
-
-   # We invoke python manually as it may not be in the path
-   pushd src/libmongoc/
-   $PYTHON build/calc_release_version.py > ../LIBMONGOC_VERSION_CURRENT
-   popd
 fi
 
 phpize

.evergreen/config/functions.yml

@@ -140,7 +140,6 @@ functions:
              echo "Checking out libmongoc version: ${LIBMONGOC_VERSION}"
              git fetch
              git checkout ${LIBMONGOC_VERSION}
-             # Note: compile-unix.sh will run `make libmongoc-version-current`
           fi
     - command: subprocess.exec
       type: test

.evergreen/config/generate-config.php

@@ -21,9 +21,7 @@
     '4.2',
 ];
 
-// TODO: Change when PHP 8.4 is stable
-// $latestPhpVersion = max($phpVersions);
-$latestPhpVersion = '8.3';
+$latestPhpVersion = max($phpVersions);
 
 // Only test the latest PHP version for libmongoc
 $libmongocBuildPhpVersions = [ $latestPhpVersion ];

.evergreen/config/generated/build/build-libmongoc.yml

@@ -10,7 +10,7 @@
       - func: "compile driver"
         vars:
           PHP_VERSION: "%phpVersion%"
-          LIBMONGOC_VERSION: "1.30.1"
+          LIBMONGOC_VERSION: "2.0.1"
       - func: "upload build"
 
   - name: "build-php-%phpVersion%-libmongoc-next-stable"
@@ -19,7 +19,7 @@
       - func: "compile driver"
         vars:
           PHP_VERSION: "%phpVersion%"
-          LIBMONGOC_VERSION: "r1.30"
+          LIBMONGOC_VERSION: "r2.0"
       - func: "upload build"
 
   - name: "build-php-%phpVersion%-libmongoc-latest"

.evergreen/config/generated/test-variant/libmongoc.yml

@@ -0,0 +1,55 @@
+name: "Build libmongoc"
+description: "Builds and install libmongoc"
+inputs:
+  prefix:
+    description: "Prefix to install libmongoc to"
+    default: "/usr/local"
+  version:
+    description: "Libmongoc version to build"
+    required: true
+runs:
+  using: composite
+
+  steps:
+    - name: Download libmongoc
+      shell: bash
+      working-directory: /tmp
+      run: wget "https://github.com/mongodb/mongo-c-driver/archive/refs/tags/${LIBMONGOC_VERSION}.tar.gz" --output-document="mongo-c-driver.tar.gz"
+      env:
+        LIBMONGOC_VERSION: ${{ inputs.version }}
+
+    - name: Extract libmongoc
+      shell: bash
+      working-directory: /tmp
+      run: tar xf "mongo-c-driver.tar.gz"
+
+    - name: Configure cmake
+      shell: bash
+      working-directory: /tmp
+      run: |
+        cmake \
+          -S "mongo-c-driver-${LIBMONGOC_VERSION}" \
+          -B _build \
+          -D CMAKE_BUILD_TYPE=RelWithDebInfo \
+          -D BUILD_VERSION="${LIBMONGOC_VERSION}" \
+          -D ENABLE_MONGOC=ON \
+          -D ENABLE_TRACING=ON \
+          -D ENABLE_CLIENT_SIDE_ENCRYPTION=ON
+      env:
+        LIBMONGOC_VERSION: ${{ inputs.version }}
+
+    - name: Build libmongoc
+      shell: bash
+      working-directory: /tmp
+      run: cmake --build _build --config RelWithDebInfo --parallel
+
+    - name: Install libmongoc
+      shell: bash
+      working-directory: /tmp
+      run: sudo cmake --install _build --prefix "${PREFIX}" --config RelWithDebInfo
+      env:
+        PREFIX: ${{ inputs.prefix }}
+
+    - name: Check pkg-config availability
+      shell: bash
+      run: pkg-config --modversion mongoc2

.evergreen/config/templates/build/build-libmongoc.yml

@@ -0,0 +1,29 @@
+name: "Build libmongocrypt"
+description: "Installs libmongocrypt"
+inputs:
+  version:
+    description: "Libmongocrypt version to install (major.minor)"
+    required: true
+runs:
+  using: composite
+
+  steps:
+    - name: Add repository key
+      shell: bash
+      run: sudo sh -c 'curl -s --location https://pgp.mongodb.com/libmongocrypt.asc | gpg --dearmor >/etc/apt/trusted.gpg.d/libmongocrypt.gpg'
+
+    - name: Add repository
+      shell: bash
+      working-directory: /tmp
+      # Note: no packages for Ubuntu 24.04 noble exist, so we use those for 22.04
+      run: echo "deb https://libmongocrypt.s3.amazonaws.com/apt/ubuntu jammy/libmongocrypt/${LIBMONGOCRYPT_VERSION} universe" | sudo tee /etc/apt/sources.list.d/libmongocrypt.list
+      env:
+        LIBMONGOCRYPT_VERSION: ${{ inputs.version }}
+
+    - name: Update apt sources
+      shell: bash
+      run: sudo apt-get update
+
+    - name: Install libmongocrypt
+      shell: bash
+      run: sudo apt-get install -y libmongocrypt-dev

.github/actions/linux/build-libmongoc/action.yml

@@ -4,6 +4,10 @@ inputs:
   version:
     description: "PHP version to build for"
     required: true
+  configureOpts:
+    description: "Extra options to use for the call to ./configure"
+    default: ""
+
 runs:
   using: composite
   steps:
@@ -17,6 +21,8 @@ runs:
     - name: "Configure driver"
       run: .github/workflows/configure.sh
       shell: bash
+      env:
+        CONFIGURE_OPTS: ${{ inputs.configureOpts }}
 
     - name: "Build driver"
       run: "make all"

.github/actions/linux/build-libmongocrypt/action.yml

@@ -128,3 +128,54 @@ jobs:
         php: [ "8.1", "8.2", "8.3", "8.4" ]
         arch: [ x64, x86 ]
         ts: [ ts, nts ]
+
+  test-system-libs:
+    name: "System Library Tests"
+    runs-on: "ubuntu-latest"
+    env:
+      PHP_VERSION: "8.3"
+      LIBMONGOCRYPT_VERSION: "1.14"
+      LIBMONGOC_VERSION: "2.0.1"
+      SERVER_VERSION: "8.0"
+
+    steps:
+      - name: "Checkout"
+        uses: "actions/checkout@v4"
+        with:
+          submodules: true
+
+      - name: "Install libmongocrypt"
+        uses: ./.github/actions/linux/build-libmongocrypt
+        with:
+          version: ${{ env.LIBMONGOCRYPT_VERSION }}
+
+      - name: "Build libmongoc"
+        uses: ./.github/actions/linux/build-libmongoc
+        with:
+          version: ${{ env.LIBMONGOC_VERSION }}
+
+      - name: "Build Driver"
+        uses: ./.github/actions/linux/build
+        with:
+          version: ${{ env.PHP_VERSION }}
+          configureOpts: "--with-mongodb-system-libs=yes"
+
+      - name: "Check driver version"
+        shell: bash
+        run: make show-config
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Setup MongoDB
+        id: setup-mongodb
+        uses: ./tests/drivers-evergreen-tools
+        with:
+          version: ${{ ENV.SERVER_VERSION }}
+          topology: "server"
+
+      - name: "Run Tests"
+        run: TEST_PHP_ARGS="-q -x --show-diff -g FAIL,XFAIL,BORK,WARN,LEAK,SKIP" make test
+        env:
+          MONGODB_URI: ${{ steps.setup-mongodb.outputs.cluster-uri }}