2026.1 release code drop

Release 2026.1.0

Author: shashankdt-perforce

RELNOTES.txt

@@ -1,7 +1,7 @@
                            Release Notes for
                          P4PHP, P4 API for PHP
 
-                            Version 2025.2
+                            Version 2026.1
 
 Introduction
 
@@ -20,14 +20,6 @@ Introduction
 
 --------------------------------------------------------------------------
 
-Important End-of-Life Notice
-
-    This major release of P4PHP would be the last to test against
-    PHP version 8.1.x, which is in EOL status. This is part of our 
-    commitment to focus on supported technology platforms.
-
---------------------------------------------------------------------------
-
 Important Product Rebrand Notice
 
 	Helix Core is now P4
@@ -61,32 +53,31 @@ Compatibility Statements
 
     Server Compatibility
 
-        This release of P4PHP supports the 2025.2 P4 Server.
+        This release of P4PHP supports the 2026.1 P4 Server.
         Older releases might work but are not supported.
 
     API Compatibility
 
-        This release of P4PHP requires the 2025.2 (2025.2/2852709) P4 C/C++ API.
+        This release of P4PHP requires the 2026.1 (2026.1/2951233) P4 C/C++ API.
         Older releases will not work and will fail to compile.
 
     OpenSSL compatibility
 
-        The minimum version of OpenSSL libraries required is driven by the
-        2025.2 server; the minimum version needed is 1.1.1. The latest 3.x.x or
-        1.1.1 patch is recommended.
+        The 2026.1 server requires OpenSSL 3.x.x.
+        It is recommended to use the latest available patch version.
 
     PHP compatibility
 
-        This release of P4PHP is compatible with PHP versions: 8.1.x - 8.5.x
+        This release of P4PHP is compatible with PHP versions: 8.2.x - 8.5.x
 
     Platform compatibility
 
         Though P4PHP is generally portable, this release is tested on the
         following platforms:
-            
+
             Linux kernel 2.6+ for Intel(x86_64)
-                Ubuntu 20.04, 22.04, 24.04
-                Rocky Linux 8, 9, 10
+                Ubuntu 22.04, 24.04
+                Rocky Linux 9, 10
             Linux kernel 2.6+ for ARM(aarch64)
                 Ubuntu 22.04, 24.04
                 Rocky Linux 9, 10
@@ -167,6 +158,13 @@ Key to symbols used in change notes below.
 
 --------------------------------------------------------------------------
 
+New functionality in 2026.1 (2026.1/2974506)(2026/06/11)
+
+    #2948829 (Job #133660) * ** ***
+        This release of P4PHP is built against P4 C/C++ API 2026.1
+
+--------------------------------------------------------------------------
+
 New functionality in 2025.2 Patch 2 (2025.2/2906131) (2026/03/05)
 
     #2904560 (Job #131389)

config.w32

@@ -52,6 +52,7 @@ if (PHP_PERFORCE != "no") {
                 ADD_FLAG("CFLAGS_PERFORCE", "/DCASE_INSENSITIVE");
 				ADD_FLAG("LDFLAGS_PERFORCE", "/NODEFAULTLIB:msvcrtd");
 				ADD_FLAG("LDFLAGS_PERFORCE", "/FORCE:MULTIPLE");
+				ADD_FLAG("LDFLAGS_PERFORCE", "iphlpapi.lib");
 
 
                 /* get information about p4api version */

php_p4.cc

@@ -1013,7 +1013,14 @@ PHP_METHOD(P4, run_password)
     params[0] = param0;
 
     array_init(&input);
-    add_next_index_zval(&input, oldpass);
+    /* On a fresh server "Secure By Default" there is no
+     * existing password, so 'p4 passwd' prompts only for the new password and
+     * its confirmation -- not the old password. 
+     * When oldpass is empty send [newpass, newpass]; otherwise send
+     * [oldpass, newpass, newpass]. */
+    if (Z_TYPE_P(oldpass) == IS_STRING && Z_STRLEN_P(oldpass) > 0) {
+        add_next_index_zval(&input, oldpass);
+    }
     add_next_index_zval(&input, newpass);
     add_next_index_zval(&input, newpass);
 

tests/005.phpt

@@ -12,21 +12,25 @@ requireP4d();
 include 'connect.inc';
 
 // test that run_login and run('login') are the same
-$results = $p4->run_login("testing123");
+$results = $p4->run_login(SUPER_PASSWORD);
 var_dump($results);
-$p4->input = "testing123";
+$p4->input = SUPER_PASSWORD;
 $results2 = $p4->run("login");
 var_dump($results2);
 
 // test that run_password and run('passwd') are the same
-$results = $p4->run_password("testing123", "testing321");
+$results = $p4->run_password(SUPER_PASSWORD, "P4Test!Pwd99");
 var_dump($results);
-$p4->input = array("testing321", "testing123", "testing123");
+$p4->password = 'P4Test!Pwd99';
+$p4->run_login('P4Test!Pwd99');
+$p4->input = array("P4Test!Pwd99", SUPER_PASSWORD, SUPER_PASSWORD);
 $results2 = $p4->run("passwd");
 var_dump($results2);
+$p4->password = SUPER_PASSWORD;
+$p4->run_login(SUPER_PASSWORD);
 
 // test that logging in still works
-$results = $p4->run_login("testing123");
+$results = $p4->run_login(SUPER_PASSWORD);
 var_dump($results);
 
 // add some files so that we can test various file related commands

tests/connect.inc

@@ -25,12 +25,18 @@ $p4->user = "tester";
 $p4->tagged = true;
 $p4->connect();
 
-// create user.
+// On p4d 2026.1+ ("Secure By Default") password authentication is enforced from
+// the very first connection; the only operation allowed pre-auth is setting the
+// initial password. Set it first (no old password on a fresh server), then log
+// in so a ticket is cached for the rest of the test.
+$p4->run_password('', SUPER_PASSWORD);
+$p4->password = SUPER_PASSWORD;
+$p4->run_login(SUPER_PASSWORD);
+
+// create user (now authenticated).
 $user = $p4->fetch_user();
 $user['Name'] = 'tester';
 $p4->save_user($user);
-$p4->run_password("testing123", "testing123");
-$p4->run_login("testing123");
 
 // create clients
 $p4->client = CLIENT_ONE_NAME;

tests/helper.inc

@@ -7,6 +7,8 @@ define('CLIENT_TWO_ROOT', getcwd() . DIRECTORY_SEPARATOR . 'client-two');
 define('CLIENT_ONE_NAME', 'test-client-1');
 define('CLIENT_TWO_NAME', 'test-client-2');
 
+define('SUPER_PASSWORD', 'P4PHP!Super1');
+
 function whichP4d()
 {
     // locate p4d binary