EasyXLS

How to set file properties for Excel file in PHP

EasyXLS Excel library can be used to export Excel files with PHP on Windows, Linux, Mac or other operating systems. The integration vary depending on the operating system or if .NET Framework or Java is chosen:

EasyXLS on Windows using .NET Framework (COM+) with PHP

If you opt for the COM+ version of EasyXLS, be sure that you have EasyXLS installed and registered on your machine.

Step 1: Download and install EasyXLS Excel Library for COM+

To download the trial version of EasyXLS Excel Library, press the below button:

Download EasyXLS™ Excel Library for COM+

If you already own a license key, you may login and download EasyXLS from your account.

Step 2: Verify if COM and .NET extension is enabled in PHP

Check PHP.ini for [COM_DOT_NET] extension.

Step 3: Verify if EasyXLS is registered

Check if EasyXLS component is present in Component Services.

Step 4: License file setup

Step required for EasyXLS v9.0 or later.

If you are using a trial, generate a trial license file from EasyXLS trials page. The trial license is valid for 30-days.

If you own a license key, you may login to the account that purchased the license and generate the license file from:
https://www.easyxls.com/my-orders

Setup the license file into your project using these guidelines.

Step 5: Run PHP code that sets custom and details properties for Excel file

Execute the following PHP code that sets the document properties of an Excel file, properties like subject, manager and a custom property.

<?php

/*=========================================================================
| Tutorial 33
|
| This tutorial shows how to set document properties for Excel file in PHP, 
| like 'Subject' property for summary information, 'Manager' property for
| document summary information and a custom property.
* =========================================================================*/

include("FileProperty.inc");

header("Content-Type: text/html");

echo "Tutorial 33<br>";
echo "----------<br>";

// Create an instance of the class that exports Excel files
$workbook = new COM("EasyXLS.ExcelDocument");

// Create a worksheet
$workbook->easy_addWorksheet_2("Sheet1");

// Set the 'Subject' document property
$workbook->getSummaryInformation()->setSubject("This is the subject");

// Set the 'Manager' document property
$workbook->getDocumentSummaryInformation()->setManager("This is the manager");

// Set a custom document property
$workbook->getDocumentSummaryInformation()->setCustomProperty("PropertyName", $VT_NUMBER, "4");

// Export Excel file
echo "Writing file: C:\Samples\Tutorial33 - Excel file properties.xlsx<br>";
$workbook->easy_WriteXLSXFile("C:\Samples\Tutorial33 - Excel file properties.xlsx");

// Confirm export of Excel file
if ($workbook->easy_getError() == "")
    echo "File successfully created.";
else
    echo "Error encountered: " .$workbook->easy_getError();

// Dispose memory
$workbook->Dispose();
$workbook = null;

?>

Overloaded methods
For methods with same name but different parameters, only the first method overload retains the original name. Subsequent overloads are uniquely renamed by appending to the method name '_2', '_3', etc (method, method_2, method_3), an integer that corresponds to the order of declaration that can be found in EasyXLS.h, a file that comes with EasyXLS installation.

EasyXLS on Linux, Mac, Windows using Java with PHP

If you opt for the Java version of EasyXLS, a similar code as above requires PHP/Java Bridge between PHP and Java.

Step 1: Download EasyXLS Excel Library for Java

To download the trial version of EasyXLS Excel Library, press the below button:

Download EasyXLS™ Excel Library for Java

If you already own a license key, you may login and download EasyXLS from your account.

Step 2: License file setup

Step required for EasyXLS v9.0 or later.

If you are using a trial, generate a trial license file from EasyXLS trials page. The trial license is valid for 30-days.

If you own a license key, you may login to the account that purchased the license and generate the license file from:
https://www.easyxls.com/my-orders

Setup the license file into your project using these guidelines.

Step 3: Install PHP/Java Bridge

Download PHP/Java Bridge and follow the PHP/Java Bridge installation guide for directions.

Step 4: Setup EasyXLS library in Tomcat

Copy EasyXLS.jar into Tomcat installation path, lib folder.

Step 5: Run PHP code that sets custom and details properties for Excel file

Execute the following PHP code that sets the document properties of an Excel file, properties like subject, manager and a custom property.

<?php require_once("http://localhost:8080/JavaBridge/java/Java.inc");

/*=========================================================================

| Tutorial 33
|
| This tutorial shows how to set document properties for Excel file in PHP, 
| like 'Subject' property for summary information, 'Manager' property for
| document summary information and a custom property.
=========================================================================*/

include("FileProperty.inc");

header("Content-Type: text/html");

echo "Tutorial 33<br>";
echo "----------<br>";

// Create an instance of the class that exports Excel files
$workbook = new java("EasyXLS.ExcelDocument");

// Create a worksheet
$workbook->easy_addWorksheet("Sheet1");

// Set the 'Subject' document property
$workbook->getSummaryInformation()->setSubject("This is the subject");

// Set the 'Manager' document property
$workbook->getDocumentSummaryInformation()->setManager("This is the manager");

// Set a custom document property
$workbook->getDocumentSummaryInformation()->setCustomProperty("PropertyName", $VT_NUMBER, "4");

// Export Excel file
echo "Writing file: C:\Samples\Tutorial33 - Excel file properties.xlsx<br>";
$workbook->easy_WriteXLSXFile("C:\Samples\Tutorial33 - Excel file properties.xlsx");

// Confirm export of Excel file
if ($workbook->easy_getError() == "")
    echo "File successfully created.";
else
    echo "Error encountered: " .$workbook->easy_getError();

// Dispose memory
$workbook->Dispose();	
  	
?>

Overloaded methods
For methods with same name but different parameters, only the first method overload retains the original name. Subsequent overloads are uniquely renamed by appending to the method name '_2', '_3', etc (method, method_2, method_3), an integer that corresponds to the order of declaration that can be found in EasyXLS.h, a file that comes with EasyXLS installation.

Linux and PHP
This code sample works just the way it is for PHP on Windows, but PHP under Linux requires also PHP/Java Bridge and a similar code sample in Java.

EasyXLS Excel libraries:

.NET
Excel Library for PHP COM+
full COM+ version to import, export or convert Excel files
Excel Writer for PHP COM+
COM+ version to create and export Excel files
-
Java
Excel Library for PHP Java
full Java version to import, export or convert Excel files
Excel Writer for PHP Java
Java version to create and export Excel files
Download EasyXLS™ Excel Library for PHP

File formats:

MS Excel 97 - 2003
MS Excel 2007 - 2019
MS Excel 2021
Office 365
XLSXXLSMXLSBXLS
XMLHTMLCSVTXT