Skip to content

Commit

Permalink
2023.2 release code drop.
Browse files Browse the repository at this point in the history 
This release of P4PHP is built against P4API 2023.2
  • Loading branch information
@hjain-perforce
hjain-perforce committed Feb 7, 2024
1 parent e6b70f7 commit 3ffaedc
Show file tree
Hide file tree
Showing 11 changed files with 204 additions and 156 deletions.
4 changes: 2 additions & 2 deletions README.md
View file
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
[![Support](https://img.shields.io/badge/Support-Official-green.svg)](mailto:[email protected])

# p4php
P4PHP is a wrapper for the P4 C++ API in PHP.
# p4php7
P4PHP7 is a wrapper for the P4 C++ API in PHP.
183 changes: 83 additions & 100 deletions RELNOTES.txt
View file
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
Release Notes for
P4PHP, Perforce's script API for PHP

Version 2020.2
Version 2023.2

Introduction

Expand All @@ -20,99 +20,72 @@ Introduction

--------------------------------------------------------------------------

Unix and Mac: Building the P4PHP Extension
Installation

Unix and Mac: Building the P4PHP Extension

To build P4PHP, you need the header files and libraries used by
PHP and the "phpize" command-line utility. Both of these
requirements can be met by installing PHP from source or by
installing the development php packages (php-devel) appropriate
for your operating system.
The official version of P4Python exists as source on:
https://github.com/perforce/p4php

After you have obtained the required files and the phpize utility,
perform the following steps:
Instructions for building are in the build.md file which can be found
here - https://github.com/perforce/p4php/blob/master/build.md


1. Download the Perforce P4PHP files.
ftp://ftp.perforce.com/perforce/r20.2/bin.tools/p4php.tgz
for the 2020.2 P4PHP.
Windows: Building the P4PHP DLL

2. Download the Perforce C++ API from the Perforce FTP site at
"ftp://ftp.perforce.com/perforce". The API archive is located
in release and platform-specific subdirectories, choose one
matching OpenSSL version available at target system and the
C library, for example p4api-glibc2.12-openssl1.1.1.tgz.
For instructions how to build P4PHP on windows please contact
[email protected]

Note: 32-bit builds of P4PHP require a 32-bit version of the
C++ API and a 32-bit version of PHP. 64-bit builds of
P4PHP require a 64-bit version of the C++ API and a
64-bit version of PHP.

3. Extract both archives into an empty directory.

4. To build P4PHP, change to the p4php-<version> directory, and run
the following commands:

phpize

./configure --with-perforce=<path to Perforce C++ API>

make

5. To test your P4PHP build, run the following command:

make test

Note: the test harness requires a copy of the Perforce server
executable, p4d, be installed in the current working
directory.

6. To install P4PHP, run the following command:

make install

Note: the installation typically needs to be performed as
the root user.

7. To enable P4PHP, edit your "php.ini" file and add the following
line:

extension=perforce.so;
--------------------------------------------------------------------------

Note: to locate your "php.ini" file, run the following command:
Compatibility Statements

php --ini
Server Compatibility

Now run:
You can use any release of P4PHP with any release of the Perforce server
later than 2001.1 but it is recommended to use the 2023.2 release

php -m
API Compatibility

to confirm that the P4PHP module is being loaded.
This release of P4PHP requires the 2023.2 (2023.2/2519561) Perforce API.
Older releases will not work and will fail to compile.

8. To verify that P4PHP works, run the following command:
OpenSSL compatibility

php --ri perforce
The minimum version of OpenSSL libraries required is driven by the
2023.2 server; the minimum version needed is 1.0.2. The latest 3.0.x or
1.1.1 patch is recommended.

If the extension is correctly installed, P4PHP displays
its version information.
PHP compatibility

SSL support
-----------
This release of P4PHP is compatible with PHP versions: 7.2.x - 8.2.x

Perforce Server 2020.2 supports SSL connections and the C++ API has
been compiled with this support. This means that in order to build
P4PHP, the underlying PHP framework must include OpenSSL.
Platform compatibility

--------------------------------------------------------------------------
Though P4PHP is generally portable, this release is tested on the
following platforms:

Linux
Ubuntu 16.04, 18.04, 20.04, 22.04
CentOS/Rocky Linux 7, 8
Windows
Server 2016

Windows: Building the P4PHP DLL
Compiler compatibility

For instructions how to build P4PHP on windows please contact [email protected]
To build P4PHP from source, you must use a version of PHP that has been
compiled with the same compiler used to build the Perforce C++ API. For
most platforms, use gcc/g++.

Attempting to use a different compiler or a different version of the
compiler causes linker errors due to differences in name handling.

--------------------------------------------------------------------------

Testing P4PHP

You can use the following small script to test P4PHP. Place it
into a file named "p4php_info.php":
You can use the following small script to test P4PHP. Place it into a file
named "p4php_info.php":

<?php
$p4 = new P4();
Expand Down Expand Up @@ -164,52 +137,62 @@ Testing P4PHP

--------------------------------------------------------------------------

Compatibility Statements
Key to symbols used in change notes below.

Server Compatibility
* -- requires new P4PHP
** -- requires P4PHP built with new P4API
*** -- requires new p4d server program

You can use any release of P4PHP with any release of the
Perforce server later than 2001.1
--------------------------------------------------------------------------

API Compatibility
New functionality in 2023.2 (2023.2/2552260) (2024/02/06)

The 2020.2 release of P4PHP requires the 2020.2 Perforce API.
Older releases will not work and will fail to compile.
#2545331 (Job #119067) * **
This release of P4PHP is built against P4API 2023.2 (2023.2/2519561)

OpenSSL compatibility
--------------------------------------------------------------------------

The minimum version of OpenSSL libraries required is driven
by the 2020.2 server; the minimum version needed is 1.0.2.
New functionality in 2023.1 Patch 1 (2023.1/2541299) (2024/01/12)

(Job #118832) * **
This release is built against P4API (2023.1/2513900),
to address possible vulnerability: CVE-2023-5759.

PHP compatibility
--------------------------------------------------------------------------

The 2020.2 release of P4PHP is compatible with PHP versions: 7.2.x - 8.0.x
New functionality in 2023.1 (2023.1/2469314) (2023/07/26)

Platform compatibility
#2457062 (Job #116145) * **
This release is built against latest P4API (2023.1/2442900)

Though P4PHP is generally portable, this release is certified
only on the following platforms:
#2468224, #2460254 (Job #114508) * **
Added support for Windows builds for PHP 8.2

Linux 2.6 Intel (x86, x86_64)
Windows 10, 2016, 2019
--------------------------------------------------------------------------

Compiler compatibility
New functionality in 2022.2 Patch 2 (2022.2/2541286) (2024/01/12)

(Job #118832) * **
This release is built against P4API (2022.2/2531894),
to address possible vulnerability: CVE-2023-5759.

To build P4PHP from source, you must use a version of PHP that
has been compiled with the same compiler used to build the
Perforce C++ API. For most platforms, use gcc/g++.
--------------------------------------------------------------------------

Attempting to use a different compiler or a different version
of the compiler causes linker errors due to differences in name
handling.
New functionality in 2022.2 Patch 1

#2389314, #2388708 (Job #113738) * **
Added support for PHP 8.2

(Job #113737) * **
This release is built against latest P4API (2022.2/2407422), which
supports OpenSSL3

--------------------------------------------------------------------------

Key to symbols used in change notes below.
New functionality in 2022.2

* -- requires new P4PHP
** -- requires P4PHP built with new P4API
*** -- requires new p4d server program
#2371665 (Job #111053) * **
Added support for PHP 8.1

--------------------------------------------------------------------------

Expand Down Expand Up @@ -456,4 +439,4 @@ Bugs fixed in 2010.1

#237983 (Job #38074) *
Text output could be truncated if it contained null characters.
This change makes handling of text output binary-safe.
This change makes handling of text output binary-safe.
1 change: 1 addition & 0 deletions config.w32
View file
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ if (PHP_PERFORCE != "no") {
CHECK_LIB("libsupp.lib", "perforce", PHP_PERFORCE) &&
CHECK_LIB("libeay32.lib", "perforce", PHP_PERFORCE) &&
CHECK_LIB("ssleay32.lib", "perforce", PHP_PERFORCE) &&
CHECK_LIB("Crypt32.lib", "perforce", PHP_PERFORCE) &&
//CHECK_LIB("advapi32.lib", "perforce") &&
//CHECK_LIB("oldnames.lib", "perforce") &&
//CHECK_LIB("kernel32.lib", "perforce") &&
Expand Down
2 changes: 1 addition & 1 deletion php_p4.cc
View file
Original file line number Diff line number Diff line change
Expand Up @@ -634,7 +634,7 @@ PHP_METHOD(P4, run)
cmdString << " " << Z_LVAL(args[i]);
break;
case IS_DOUBLE:
cmdString << " " << Z_DVAL(args[i]);
cmdString << " " << static_cast<P4INT64>(Z_DVAL(args[i]));
break;
case IS_TRUE:
cmdString << " " << "TRUE";
Expand Down
Loading

0 comments on commit 3ffaedc

Please sign in to comment.