Add stubs for PAM.

https://github.com/amishmm/php-pam

pam/pam.php

@@ -0,0 +1,49 @@
+<?php
+
+use JetBrains\PhpStorm\Pure;
+
+/**
+ * Authorize against a PAM unix database.
+ *
+ * @param string $username <p>
+ * The username to check.
+ * </p>
+ * @param string $password <p>
+ * The user-supplied password to check.
+ * </p>
+ * @param string $error <p>
+ * Output parameter to put any error messages in.
+ * </p>
+ * @param bool $check_account_management <p>
+ * Call <b>pam_acct_mgmt()</b> to check account expiration and access. (Requires root access!)
+ * </p>
+ * @param string $service_name <p>
+ * PAM service name to use. (Defaults to "php")
+ * </p>
+ * @return bool Returns a bool when complete. If false, <b>$error</b> contains any error messages generated.
+ */
+#[Pure]
+function pam_auth(string $username, string $password, string $error, bool $check_account_management = true, string $service_name = 'php') {}
+
+/**
+ * Change a password for a PAM unix account.
+ *
+ * @param string $username <p>
+ * The username to check.
+ * </p>
+ * @param string $old_password <p>
+ * The current password for the account.
+ * </p>
+ * @param string $new_password <p>
+ * The new password for the account.
+ * </p>
+ * @param string $error <p>
+ * Output parameter to put any error messages in.
+ * </p>
+ * @param string $service_name <p>
+ * PAM service name to use. (Defaults to "php")
+ * </p>
+ * @return bool Returns a bool when complete. If false, <b>$error</b> contains any error messages generated.
+ */
+#[Pure]
+function pam_chpass(string $username, string $old_password, string $new_password, string $error, string $service_name = 'php') {}

tests/DockerImages/peclExtensions/Dockerfile

@@ -6,7 +6,7 @@ RUN set -eux; \
     libmcrypt-dev imap-dev php8-imap enchant2 php8-enchant bzip2-dev gettext-dev libxml2-dev php8-dev php8-gd icu-dev \
     php8-zip php8-tidy php8-intl libffi-dev openssl-dev php8-pear rabbitmq-c rabbitmq-c-dev librrd \
     libzip-dev rrdtool-dev gmp-dev yaml yaml-dev fann fann-dev openldap-dev librdkafka librdkafka-dev libcurl curl-dev \
-    libpng-dev gpgme gpgme-dev
+    libpng-dev gpgme gpgme-dev linux-pam-dev
 
 RUN pecl install xdebug
 RUN docker-php-ext-enable xdebug
@@ -48,5 +48,7 @@ RUN pecl install gnupg
 RUN docker-php-ext-enable gnupg
 RUN pecl install uopz
 RUN docker-php-ext-enable uopz
+RUN pecl install pam
+RUN docker-php-ext-enable pam
 
 WORKDIR /opt/project/phpstorm-stubs