chore: sync upstream

.editorconfig

@@ -6,4 +6,7 @@ end_of_line = lf
 insert_final_newline = true
 indent_style = space
 indent_size = 4
-trim_trailing_whitespace = true
+trim_trailing_whitespace = true
+
+[*.yml]
+indent_size = 2

.gitattributes

@@ -1,3 +1,12 @@
-/tests              export-ignore
-/.*                 export-ignore
-/phpunit.xml.dist   export-ignore
+/.github                 export-ignore
+/.phpunit.cache          export-ignore
+/docs                    export-ignore
+/tests                   export-ignore
+*.md                     export-ignore
+*.dist                   export-ignore
+.editorconfig            export-ignore
+.gitattributes           export-ignore
+.gitignore               export-ignore
+docker-compose.yml       export-ignore
+Dockerfile               export-ignore
+phpstan-baseline.neon    export-ignore

.github/CODEOWNERS

@@ -0,0 +1,2 @@
+* @mongodb/dbx-php
+/docs @mongodb/docs-drivers-team

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,12 @@
+blank_issues_enabled: false
+
+contact_links:
+  - name: Discussions
+    url: https://github.com/mongodb/laravel-mongodb/discussions/new/choose
+    about: For questions, discussions, or general technical support from other Laravel users, visit the Discussions page.
+  - name: MongoDB Developer Community Forums
+    url: https://developer.mongodb.com/community/forums/
+    about: For questions, discussions, or general technical support, visit the MongoDB Community Forums. The MongoDB Community Forums are a centralized place to connect with other MongoDB users, ask questions, and get answers.
+  - name: Report a Security Vulnerability
+    url: https://mongodb.com/docs/manual/tutorial/create-a-vulnerability-report
+    about: If you believe you have discovered a vulnerability in MongoDB products or have experienced a security incident related to MongoDB products, please report the issue to aid in its resolution.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,10 @@
+<!--
+Replace this notice by a description of your feature/bugfix.
+This will help reviewers and should be a good start for the documentation.
+-->
+
+### Checklist
+
+- [ ] Add tests and ensure they pass
+- [ ] Add an entry to the CHANGELOG.md file
+- [ ] Update documentation for new features

.github/dependabot.yml

@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

.github/labeler.yml

@@ -0,0 +1,7 @@
+# https://github.com/actions/labeler
+docs:
+  - changed-files:
+    - any-glob-to-any-file: 'docs/**'
+github:
+  - changed-files:
+    - any-glob-to-any-file: '.github/**'

.github/release.yml

@@ -0,0 +1,21 @@
+changelog:
+  exclude:
+    labels:
+      - ignore-for-release
+      - minor
+    authors:
+      - mongodb-php-bot
+  categories:
+    - title: Breaking Changes 🛠
+      labels:
+        - breaking-change
+    - title: New Features
+      labels:
+        - enhancement
+    - title: Fixed
+      labels:
+        - bug
+        - fixed
+    - title: Other Changes
+      labels:
+        - "*"

.github/workflows/build-ci.yml

@@ -1,97 +1,96 @@
-name: CI
+name: "CI"
 
 on:
     push:
-        branches:
-        tags:
     pull_request:
 
 jobs:
-    php-cs-fixer:
-        runs-on: ubuntu-latest
-        env:
-            PHP_CS_FIXER_VERSION: v3.6.0
-        strategy:
-            matrix:
-                php:
-                    - '8.0'
-        steps:
-            -   name: Checkout
-                uses: actions/checkout@v2
-            -   name: Setup PHP
-                uses: shivammathur/setup-php@v2
-                with:
-                    php-version: ${{ matrix.php }}
-                    extensions: curl,mbstring
-                    tools: php-cs-fixer:${{ env.PHP_CS_FIXER_VERSION }}
-                    coverage: none
-            -   name: Run PHP-CS-Fixer Fix, version ${{ env.PHP_CS_FIXER_VERSION }}
-                run: php-cs-fixer fix --dry-run --diff --ansi
-
     build:
-        runs-on: ${{ matrix.os }}
-        name: PHP v${{ matrix.php }} with Mongo v${{ matrix.mongodb }}
-        continue-on-error: ${{ matrix.experimental }}
+        runs-on: "${{ matrix.os }}"
+
+        name: "PHP ${{ matrix.php }} Laravel ${{ matrix.laravel }} MongoDB ${{ matrix.mongodb }} ${{ matrix.mode }}"
+
         strategy:
             matrix:
+                os:
+                    - "ubuntu-latest"
+                mongodb:
+                    - "4.4"
+                    - "5.0"
+                    - "6.0"
+                    - "7.0"
+                php:
+                    - "8.1"
+                    - "8.2"
+                    - "8.3"
+                laravel:
+                    - "10.*"
+                    - "11.*"
                 include:
-                    - { os: ubuntu-latest, php: 8.0, mongodb: '4.0', experimental: false }
-                    - { os: ubuntu-latest, php: 8.0, mongodb: 4.2, experimental: false }
-                    - { os: ubuntu-latest, php: 8.0, mongodb: 4.4, experimental: false }
-                    - { os: ubuntu-latest, php: 8.0, mongodb: '5.0', experimental: false }
-                    - { os: ubuntu-latest, php: 8.1, mongodb: '4.0', experimental: false }
-                    - { os: ubuntu-latest, php: 8.1, mongodb: 4.2, experimental: false }
-                    - { os: ubuntu-latest, php: 8.1, mongodb: 4.4, experimental: false }
-                    - { os: ubuntu-latest, php: 8.1, mongodb: '5.0', experimental: false }
-        services:
-            mongo:
-                image: mongo:${{ matrix.mongodb }}
-                ports:
-                    - 27017:27017
-            mysql:
-                image: mysql:5.7
-                ports:
-                    - 3307:3306
-                env:
-                    MYSQL_ALLOW_EMPTY_PASSWORD: 'yes'
-                    MYSQL_DATABASE: 'unittest'
-                    MYSQL_ROOT_PASSWORD:
+                    - php: "8.1"
+                      laravel: "10.*"
+                      mongodb: "5.0"
+                      mode: "low-deps"
+                      os: "ubuntu-latest"
+                    - php: "8.4"
+                      laravel: "11.*"
+                      mongodb: "7.0"
+                      mode: "ignore-php-req"
+                      os: "ubuntu-latest"
+                exclude:
+                    - php: "8.1"
+                      laravel: "11.*"
 
         steps:
-            -   uses: actions/checkout@v2
+            -   uses: "actions/checkout@v4"
+
+            -   name: "Create MongoDB Replica Set"
+                run: |
+                    docker run --name mongodb -p 27017:27017 -e MONGO_INITDB_DATABASE=unittest --detach mongo:${{ matrix.mongodb }} mongod --replSet rs --setParameter transactionLifetimeLimitSeconds=5
+
+                    if [ "${{ matrix.mongodb }}" = "4.4" ]; then MONGOSH_BIN="mongo"; else MONGOSH_BIN="mongosh"; fi
+                    until docker exec --tty mongodb $MONGOSH_BIN 127.0.0.1:27017 --eval "db.runCommand({ ping: 1 })"; do
+                    sleep 1
+                    done
+                    sudo docker exec --tty mongodb $MONGOSH_BIN 127.0.0.1:27017 --eval "rs.initiate({\"_id\":\"rs\",\"members\":[{\"_id\":0,\"host\":\"127.0.0.1:27017\" }]})"
+
+            -   name: "Show MongoDB server status"
+                run: |
+                    if [ "${{ matrix.mongodb }}" = "4.4" ]; then MONGOSH_BIN="mongo"; else MONGOSH_BIN="mongosh"; fi
+                    docker exec --tty mongodb $MONGOSH_BIN 127.0.0.1:27017 --eval "db.runCommand({ serverStatus: 1 })"
+
             -   name: "Installing php"
-                uses: shivammathur/setup-php@v2
+                uses: "shivammathur/setup-php@v2"
                 with:
                     php-version: ${{ matrix.php }}
-                    extensions: curl,mbstring,xdebug
-                    coverage: xdebug
-                    tools: composer
-            -   name: Show PHP version
-                run: php -v && composer -V
-            -   name: Show Docker version
-                run: if [[ "$DEBUG" == "true" ]]; then docker version && env; fi
-                env:
-                    DEBUG: ${{secrets.DEBUG}}
-            -   name: Download Composer cache dependencies from cache
-                id: composer-cache
-                run: echo "::set-output name=dir::$(composer config cache-files-dir)"
-            -   name: Cache Composer dependencies
-                uses: actions/cache@v1
+                    extensions: "curl,mbstring,xdebug"
+                    coverage: "xdebug"
+                    tools: "composer"
+
+            -   name: "Show Docker version"
+                if: ${{ runner.debug }}
+                run: "docker version && env"
+
+            -   name: "Restrict Laravel version"
+                run: "composer require --dev --no-update 'laravel/framework:${{ matrix.laravel }}'"
+
+            -   name: "Download Composer cache dependencies from cache"
+                id: "composer-cache"
+                run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
+            -   name: "Cache Composer dependencies"
+                uses: "actions/cache@v4"
                 with:
                     path: ${{ steps.composer-cache.outputs.dir }}
-                    key: ${{ matrix.os }}-composer-${{ hashFiles('**/composer.json') }}
-                    restore-keys: ${{ matrix.os }}-composer-
-            -   name: Install dependencies
-                run: |
-                    composer install --no-interaction
-            -   name: Run tests
+                    key: "${{ matrix.os }}-composer-${{ hashFiles('**/composer.json') }}"
+                    restore-keys: "${{ matrix.os }}-composer-"
+
+            -   name: "Install dependencies"
                 run: |
-                    ./vendor/bin/phpunit --coverage-clover coverage.xml
+                  composer update --no-interaction \
+                    $([[ "${{ matrix.mode }}" == low-deps ]] && echo ' --prefer-lowest') \
+                    $([[ "${{ matrix.mode }}" == ignore-php-req ]] && echo ' --ignore-platform-req=php+')
+            -   name: "Run tests"
+                run: "./vendor/bin/phpunit --coverage-clover coverage.xml"
                 env:
-                    MONGO_HOST: 0.0.0.0
-                    MYSQL_HOST: 0.0.0.0
-                    MYSQL_PORT: 3307
-            -   uses: codecov/codecov-action@v1
-                with:
-                    token: ${{ secrets.CODECOV_TOKEN }}
-                    fail_ci_if_error: false
+                    MONGODB_URI: 'mongodb://127.0.0.1/?replicaSet=rs'

.github/workflows/coding-standards.yml

@@ -0,0 +1,69 @@
+name: "Coding Standards"
+
+on:
+  push:
+  pull_request:
+
+env:
+  PHP_VERSION: "8.2"
+  DRIVER_VERSION: "stable"
+
+jobs:
+  phpcs:
+    name: "phpcs"
+    runs-on: "ubuntu-22.04"
+
+    permissions:
+      # Give the default GITHUB_TOKEN write permission to commit and push the
+      # added or changed files to the repository.
+      contents: write
+
+    steps:
+      - name: "Checkout"
+        uses: "actions/checkout@v4"
+
+      - name: "Setup cache environment"
+        id: "extcache"
+        uses: "shivammathur/cache-extensions@v1"
+        with:
+          php-version: ${{ env.PHP_VERSION }}
+          extensions: "mongodb-${{ env.DRIVER_VERSION }}"
+          key: "extcache-v1"
+
+      - name: "Cache extensions"
+        uses: "actions/cache@v4"
+        with:
+          path: ${{ steps.extcache.outputs.dir }}
+          key: ${{ steps.extcache.outputs.key }}
+          restore-keys: ${{ steps.extcache.outputs.key }}
+
+      - name: "Install PHP"
+        uses: "shivammathur/setup-php@v2"
+        with:
+          coverage: "none"
+          extensions: "mongodb-${{ env.DRIVER_VERSION }}"
+          php-version: ${{ env.PHP_VERSION }}
+          tools: "cs2pr"
+
+      - name: "Show driver information"
+        run: "php --ri mongodb"
+
+      - name: "Install dependencies with Composer"
+        uses: "ramsey/[email protected]"
+        with:
+          composer-options: "--no-suggest"
+
+      - name: "Format the code"
+        continue-on-error: true
+        run: |
+          mkdir .cache
+          ./vendor/bin/phpcbf
+
+      # The -q option is required until phpcs v4 is released
+      - name: "Run PHP_CodeSniffer"
+        run: "vendor/bin/phpcs -q --no-colors --report=checkstyle | cs2pr"
+
+      - name: "Commit the changes"
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "apply phpcbf formatting"

.github/workflows/labeler.yml

@@ -0,0 +1,12 @@
+name: "Pull Request Labeler"
+on:
+  - pull_request_target
+
+jobs:
+  labeler:
+    permissions:
+      contents: read
+      pull-requests: write
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/labeler@v5

.github/workflows/merge-up.yml

@@ -0,0 +1,31 @@
+name: Merge up
+
+on:
+  push:
+    branches:
+      - "[0-9]+.[0-9]+"
+
+env:
+  GH_TOKEN: ${{ secrets.MERGE_UP_TOKEN }}
+
+jobs:
+  merge-up:
+    name: Create merge up pull request
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        id: checkout
+        uses: actions/checkout@v4
+        with:
+          # fetch-depth 0 is required to fetch all branches, not just the branch being built
+          fetch-depth: 0
+          token: ${{ secrets.MERGE_UP_TOKEN }}
+
+      - name: Create pull request
+        id: create-pull-request
+        uses: alcaeus/automatic-merge-up-action@main
+        with:
+          ref: ${{ github.ref_name }}
+          branchNamePattern: '<major>.<minor>'
+          enableAutoMerge: true