EasyXLS

How to add hyperlinks 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 adds hyperlinks to Excel

Execute the following PHP code that exports an Excel file with hyperlinks on a cell or cell ranges.

<?php

/*===================================================================================
| Tutorial 15
|
| This tutorial shows how to create an Excel file with hyperlinks in PHP.
|
| EasyXLS supports the following hyperlink types:
|		1 - hyperlink to URL 
|		2 - hyperlink to file
|		3 - hyperlink to UNC
|		4 - hyperlink to cell in the same Excel file
|		5 - hyperlink to name
|
| The link can be placed on a range of cells.
|
| Every type of hyperlink accepts a tool tip description.
|
| Every type of hyperlink accepts a text mark. A text mark is a link inside the file.
* =================================================================================*/

include("HyperlinkType.inc");

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

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

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

// Create two sheets
$workbook->easy_addWorksheet_2("First tab");
$workbook->easy_addWorksheet_2("Second tab");

$xlsTab1 = $workbook->easy_getSheetAt(0);
$xlsTab2 = $workbook->easy_getSheetAt(1);

// Create hyperlink to URL
$xlsTab1->easy_addHyperlink_3($HYPERLINKTYPE_URL, "https://www.easyxls.com", "Link to URL", "B2:E2");

// Create hyperlink to file
$xlsTab1->easy_addHyperlink_3($HYPERLINKTYPE_FILE, "c:\\myfile.xls", "Link to file", "B3");

// Create hyperlink to UNC
$xlsTab1->easy_addHyperlink_3($HYPERLINKTYPE_UNC, "\\\\computerName\\Folder\\file.txt",
                                                  "Link to UNC", "B4:D4");

// Create hyperlink to cell on second sheet
$xlsTab1->easy_addHyperlink_3($HYPERLINKTYPE_CELL, "'Second tab'!D3", "Link to CELL", "B5");

// Create a name on the second sheet
$xlsTab2->easy_addName_2("Name", "=Second tab!\$A\$1:\$A\$4");

// Create hyperlink to name
$xlsTab1->easy_addHyperlink_3($HYPERLINKTYPE_CELL, "Name", "Link to a name", "B6");

// Export Excel file
echo "Writing file: C:\Samples\Tutorial15 - hyperlinks in Excel.xlsx<br>";
$workbook->easy_WriteXLSXFile("C:\Samples\Tutorial15 - hyperlinks in Excel.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 and install 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 adds hyperlinks to Excel

Execute the following PHP code that exports an Excel file with hyperlinks on a cell or cell ranges.

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

/*==================================================================================
| Tutorial 15
|
This tutorial shows how to create an Excel file with hyperlinks in PHP.
|
| EasyXLS supports the following hyperlink types:
|       1 - hyperlink to URL
|       2 - hyperlink to file
|       3 - hyperlink to UNC
|       4 - hyperlink to cell in the same Excel file
|       5 - hyperlink to name
|
| The link can be placed on a range of cells.
|
| Every type of hyperlink accepts a tool tip description.
|
| Every type of hyperlink accepts a text mark. A text mark is a link inside the file.
===================================================================================*/

include("HyperlinkType.inc");

header("Content-Type: text/html");
	
echo "Tutorial 15<br>";
echo "----------<br>";
	
// Create an instance of the class that exports Excel files
$workbook = new java("EasyXLS.ExcelDocument");
	
// Create two sheets
$workbook->easy_addWorksheet("First tab");
$workbook->easy_addWorksheet("Second tab");
	
$xlsTab1 = $workbook->easy_getSheetAt(0);
$xlsTab2 = $workbook->easy_getSheetAt(1);
	
// Create hyperlink to URL
$xlsTab1->easy_addHyperlink($HYPERLINKTYPE_URL, "https://www.easyxls.com", "Link to URL", "B2:E2");

// Create hyperlink to file
$xlsTab1->easy_addHyperlink($HYPERLINKTYPE_FILE, "c:\\myfile.xls", "Link to file", "B3");

// Create hyperlink to UNC
$xlsTab1->easy_addHyperlink($HYPERLINKTYPE_UNC, "\\\\computerName\\Folder\\file.txt",
                                                "Link to UNC", "B4:D4");

// Create hyperlink to cell on second sheet
$xlsTab1->easy_addHyperlink($HYPERLINKTYPE_CELL, "'Second tab'!D3", "Link to CELL", "B5");

// Create a name on the second sheet
$xlsTab2->easy_addName("Name", "=Second tab!\$A\$1:\$A\$4");
	
// Create hyperlink to name
$xlsTab1->easy_addHyperlink($HYPERLINKTYPE_CELL, "Name", "Link to a name", "B6");

// Export Excel file
echo "Writing file: C:\Samples\Tutorial15 - hyperlinks in Excel.xlsx<br>";
$workbook->easy_WriteXLSXFile("C:\Samples\Tutorial15 - hyperlinks in Excel.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();

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