Add initial stub

Author: Ayesh

.gitattributes

@@ -0,0 +1,12 @@
+# https://php.watch/articles/composer-gitattributes
+
+# Exclude build/test files from archive
+/.github          export-ignore
+/build            export-ignore
+/tests            export-ignore
+/.gitattributes   export-ignore
+/.gitignore       export-ignore
+/phpunit.xml.dist export-ignore
+
+# Configure diff output for .php and .phar files.
+*.php diff=php

.github/workflows/ci.yml

@@ -0,0 +1,42 @@
+on:
+  - pull_request
+  - push
+
+name: CI
+
+jobs:
+  tests:
+    name: Tests
+    runs-on: ${{ matrix.os }}
+
+    strategy:
+      matrix:
+        os:
+          - ubuntu-latest
+          - windows-latest
+        php:
+          - "7.1"
+          - "7.2"
+          - "7.3"
+          - "7.4"
+          - "8.0"
+          - "8.1"
+          - "8.2"
+          - "8.3"
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install PHP with extensions
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php }}
+          coverage: pcov
+          ini-values: assert.exception=1, zend.assertions=1
+
+      - name: Install composer dependencies
+        run: composer update --no-ansi --no-interaction --no-progress
+
+      - name: Run tests with phpunit
+        run: vendor/bin/phpunit

.gitignore

@@ -0,0 +1,3 @@
+/vendor/
+/build/
+composer.lock

README.md

@@ -0,0 +1,22 @@
+# `array_find`, `array_find_key`, `array_any` and `array_all` polyfills
+
+[![Latest Stable Version](https://poser.pugx.org/polyfills/array-find/v)](https://packagist.org/packages/polyfills/array-find) [![License](https://poser.pugx.org/polyfills/array-find/license)](https://packagist.org/packages/polyfills/array-find) [![PHP Version Require](https://poser.pugx.org/polyfills/array-find/require/php)](https://packagist.org/packages/polyfills/array-find)
+
+Provides user-land PHP polyfills for the `array_find`, `array_find_key`, `array_any` and `array_all` functions added in PHP 8.4.
+
+Requires PHP 7.1 or later. Not supported on PHP 8.4 because these functions are natively implemented in PHP 8.4.
+
+## Installation
+
+```bash
+composer require polyfills/array-find
+```
+
+## Usage
+
+Simply use the `array_find`, `array_find_key`, `array_any` and `array_all` functions as if they were declared already.
+
+## Contributions
+
+Contributions are welcome either as a GitHub issue or a PR to this repo.
+

composer.json

@@ -0,0 +1,28 @@
+{
+    "name": "polyfills/array-find",
+    "description": "PHP: Provides a user-land polyfill for `array_find`, `array_find_key`, `array_any` and `array_all` functions added in PHP 8.4.",
+    "type": "library",
+    "homepage": "https://php.watch/versions/8.4/array_find-array_find_key-array_any-array_all",
+    "keywords": ["php84", "phpwatch", "polyfills", "polyfill", "compatibility", "compat", "shim"],
+    "require": {
+        "php": "^8.0"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "^10.5.20"
+    },
+    "conflict": {
+        "php": "^8.4"
+    },
+    "license": "MIT",
+    "autoload": {
+        "files": [
+            "src/array_find.php"
+        ]
+    },
+    "authors": [
+        {
+            "name": "Ayesh Karunaratne",
+            "email": "[email protected]"
+        }
+    ]
+}

phpunit.xml.dist

@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.5/phpunit.xsd"
+         bootstrap="vendor/autoload.php"
+         executionOrder="depends,defects"
+         beStrictAboutOutputDuringTests="true"
+         colors="true"
+         cacheDirectory=".phpunit.cache"
+         failOnWarning="true"
+         failOnRisky="true"
+         failOnDeprecation="true"
+         failOnIncomplete="true"
+         failOnNotice="true"
+         failOnEmptyTestSuite="true"
+         beStrictAboutChangesToGlobalState="true"
+         testdox="true"
+         beStrictAboutCoverageMetadata="true">
+    <testsuites>
+        <testsuite name="default">
+            <directory>tests</directory>
+        </testsuite>
+    </testsuites>
+    <coverage>
+        <report>
+            <html outputDirectory="build/coverage-html"/>
+            <text outputFile="php://stdout"/>
+        </report>
+    </coverage>
+    <source>
+        <include>
+            <directory>src</directory>
+        </include>
+    </source>
+</phpunit>