2019年10月11日14:09:40
配置设定
将PhpSpreadsheet文件包含在脚本中之后,但是在实例化Spreadsheet
对象或加载工作簿文件之前,可以设置许多配置选项,这些配置选项将影响脚本的后续行为。
单元格收集缓存
默认情况下,PhpSpreadsheet将所有单元格对象保留在内存中,但是您可以指定替代方法来以降低速度为代价来减少内存消耗。阅读有关内存节省的更多信息。
为了使细胞缓存,您必须提供自己的实现,像这样的缓存:
$cache = new MyCustomPsr16Implementation();
\PhpOffice\PhpSpreadsheet\Settings::setCache($cache);
语言/地区
PhpSpreadsheet中已包含一些本地化元素。您可以通过更改设置来设置语言环境。要将语言环境设置为巴西葡萄牙语,请使用:
$locale = 'pt_br';
$validLocale = \PhpOffice\PhpSpreadsheet\Settings::setLocale($locale);
if (!$validLocale) {
echo 'Unable to set locale to ' . $locale . " - reverting to en_us" . PHP_EOL;
}
- 如果巴西葡萄牙语文件不可用,则将启用葡萄牙语
- 如果没有葡萄牙语文件,则该
setLocale()
方法将返回错误,并且将始终使用美式英语(en_us)设置。
设置语言环境后,可以使用可用功能的更多详细信息,包括当前支持的语言和语言环境列表,可以在“公式的语言环境设置”中找到。
工作表
工作表是单元格,公式,图像,图形等的集合。它包含代表电子表格工作表所需的所有数据。
当您从电子表格文件加载工作簿时,它将与所有现有工作表一起加载(除非您指定仅应加载某些工作表)。从非电子表格文件(例如CSV或HTML文件)或无法通过名称识别工作表的电子表格格式(例如SYLK)加载时,将创建一个名为“ WorkSheet1”的工作表,其中包含来自该文件。
当您实例化一个新的工作簿时,PhpSpreadsheet将使用一个名为“ WorkSheet1”的工作表来创建它。
该getSheetCount()
方法将告诉您工作簿中工作表的数量。而该getSheetNames()
方法将返回工作簿中所有工作表的列表,并按在MS Excel(或其他适当的Spreadsheet程序)中打开时其“选项卡”出现的顺序编制索引。
可以通过名称或在工作簿中的索引位置访问各个工作表。索引位置代表在MS Excel(或其他适当的电子表格程序)中打开工作簿时显示每个工作表“标签”的顺序。要通过工作表的索引访问工作表,请使用getSheet()
方法。
// Get the second sheet in the workbook
// Note that sheets are indexed from 0
$spreadsheet->getSheet(1);
还存在允许您在工作簿中对工作表进行重新排序的方法。
要按名称访问工作表,请使用getSheetByName()
方法,指定要访问的工作表的名称。
// Retrieve the worksheet called 'Worksheet 1'
$spreadsheet->getSheetByName('Worksheet 1');
或者,一个工作表始终是当前活动的工作表,您可以直接访问该工作表。当前活动的工作表是在MS Excel(或其他适当的Spreadsheet程序)中打开工作簿时将处于活动状态的工作表。
// Retrieve the current active worksheet
$spreadsheet->getActiveSheet();
您可以使用setActiveSheetIndex()
和setActiveSheetIndexByName()
方法通过索引或名称更改当前活动的工作表 。
添加一个新的工作表
您可以使用对象的createSheet()
方法向工作簿中添加一个新的工作表Spreadsheet
。默认情况下,它将被创建为新的“最后”工作表;但您也可以将索引位置指定为参数,然后工作表将插入该位置,从而将集合中所有后续工作表拖到一个位置。
$spreadsheet->createSheet();
使用此方法创建的新工作表将被调用 Worksheet<n>
,其中where <n>
是保证标题唯一的最低编号。
或者,您可以实例化一个新的工作表(将标题设置为您选择的名称),然后使用该addSheet()
方法将其插入工作簿中 。
// Create a new worksheet called "My Data"
$myWorkSheet = new \PhpOffice\PhpSpreadsheet\Worksheet\Worksheet($spreadsheet, 'My Data');
// Attach the "My Data" worksheet as the first worksheet in the Spreadsheet object
$spreadsheet->addSheet($myWorkSheet, 0);
如果未将索引位置指定为第二个参数,则新工作表将添加到最后一个现有工作表之后。
复制工作表
可以通过创建要复制的工作表的副本,然后使用addSheet()
将该副本插入工作簿的方法来复制同一工作簿中的工作表。
$clonedWorksheet = clone $spreadsheet->getSheetByName('Worksheet 1');
$clonedWorksheet->setTitle('Copy of Worksheet 1');
$spreadsheet->addSheet($clonedWorksheet);
您还可以将工作表从一个工作簿复制到另一个工作簿,尽管这更加复杂,因为PhpSpreadsheet还必须在两个工作簿之间复制样式。addExternalSheet()
为此提供了该方法。
$clonedWorksheet = clone $spreadsheet1->getSheetByName('Worksheet 1');
$spreadsheet->addExternalSheet($clonedWorksheet);
在这两种情况下,开发人员都有责任确保工作表名称不重复。如果您尝试复制将导致名称重复的工作表,则PhpSpreadsheet将引发异常。
删除工作表
您可以使用以下removeSheetByIndex()
方法从工作簿中删除工作表,该工作表由其索引位置标识
$sheetIndex = $spreadsheet->getIndex(
$spreadsheet->getSheetByName('Worksheet 1')
);
$spreadsheet->removeSheetByIndex($sheetIndex);
如果删除了当前活动的工作表,则位于前一个索引位置的工作表将成为当前活动的工作表。