PhpSpreadsheet/docs/ReadingSpreadsheetFiles/07-Helper-Methods.md

1.6 KiB
Raw Blame History

PhpSpreadsheet User Documentation Reading Spreadsheet Files

Helper Methods

You can retrieve a list of worksheet names contained in a file without loading the whole file by using the Readers listWorksheetNames() method; similarly, a listWorksheetInfo() method will retrieve the dimensions of worksheet in a file without needing to load and parse the whole file.

listWorksheetNames

The listWorksheetNames() method returns a simple array listing each worksheet name within the workbook:

$objReader = \PhpOffice\PhpSpreadsheet\IOFactory::createReader($inputFileType);

$worksheetNames = $objReader->listWorksheetNames($inputFileName);

echo '<h3>Worksheet Names</h3>';
echo '<ol>';
foreach ($worksheetNames as $worksheetName) {
    echo '<li>', $worksheetName, '</li>';
}
echo '</ol>';

See Examples/Reader/exampleReader18.php for a working example of this code.

listWorksheetInfo

The listWorksheetInfo() method returns a nested array, with each entry listing the name and dimensions for a worksheet:

$objReader = \PhpOffice\PhpSpreadsheet\IOFactory::createReader($inputFileType);

$worksheetData = $objReader->listWorksheetInfo($inputFileName);

echo '<h3>Worksheet Information</h3>';
echo '<ol>';
foreach ($worksheetData as $worksheet) {
    echo '<li>', $worksheet['worksheetName'], '<br />';
    echo 'Rows: ', $worksheet['totalRows'],
         ' Columns: ', $worksheet['totalColumns'], '<br />';
    echo 'Cell Range: A1:',
    $worksheet['lastColumnLetter'], $worksheet['totalRows'];
    echo '</li>';
}
echo '</ol>';

See Examples/Reader/exampleReader19.php for a working example of this code.