692 lines
11 KiB
PHP
692 lines
11 KiB
PHP
<?php
|
|
|
|
namespace PhpOffice\PhpSpreadsheet\Worksheet;
|
|
|
|
use PhpOffice\PhpSpreadsheet\Shared\PasswordHasher;
|
|
|
|
class Protection
|
|
{
|
|
const ALGORITHM_MD2 = 'MD2';
|
|
const ALGORITHM_MD4 = 'MD4';
|
|
const ALGORITHM_MD5 = 'MD5';
|
|
const ALGORITHM_SHA_1 = 'SHA-1';
|
|
const ALGORITHM_SHA_256 = 'SHA-256';
|
|
const ALGORITHM_SHA_384 = 'SHA-384';
|
|
const ALGORITHM_SHA_512 = 'SHA-512';
|
|
const ALGORITHM_RIPEMD_128 = 'RIPEMD-128';
|
|
const ALGORITHM_RIPEMD_160 = 'RIPEMD-160';
|
|
const ALGORITHM_WHIRLPOOL = 'WHIRLPOOL';
|
|
|
|
/**
|
|
* Sheet.
|
|
*
|
|
* @var bool
|
|
*/
|
|
private $sheet = false;
|
|
|
|
/**
|
|
* Objects.
|
|
*
|
|
* @var bool
|
|
*/
|
|
private $objects = false;
|
|
|
|
/**
|
|
* Scenarios.
|
|
*
|
|
* @var bool
|
|
*/
|
|
private $scenarios = false;
|
|
|
|
/**
|
|
* Format cells.
|
|
*
|
|
* @var bool
|
|
*/
|
|
private $formatCells = false;
|
|
|
|
/**
|
|
* Format columns.
|
|
*
|
|
* @var bool
|
|
*/
|
|
private $formatColumns = false;
|
|
|
|
/**
|
|
* Format rows.
|
|
*
|
|
* @var bool
|
|
*/
|
|
private $formatRows = false;
|
|
|
|
/**
|
|
* Insert columns.
|
|
*
|
|
* @var bool
|
|
*/
|
|
private $insertColumns = false;
|
|
|
|
/**
|
|
* Insert rows.
|
|
*
|
|
* @var bool
|
|
*/
|
|
private $insertRows = false;
|
|
|
|
/**
|
|
* Insert hyperlinks.
|
|
*
|
|
* @var bool
|
|
*/
|
|
private $insertHyperlinks = false;
|
|
|
|
/**
|
|
* Delete columns.
|
|
*
|
|
* @var bool
|
|
*/
|
|
private $deleteColumns = false;
|
|
|
|
/**
|
|
* Delete rows.
|
|
*
|
|
* @var bool
|
|
*/
|
|
private $deleteRows = false;
|
|
|
|
/**
|
|
* Select locked cells.
|
|
*
|
|
* @var bool
|
|
*/
|
|
private $selectLockedCells = false;
|
|
|
|
/**
|
|
* Sort.
|
|
*
|
|
* @var bool
|
|
*/
|
|
private $sort = false;
|
|
|
|
/**
|
|
* AutoFilter.
|
|
*
|
|
* @var bool
|
|
*/
|
|
private $autoFilter = false;
|
|
|
|
/**
|
|
* Pivot tables.
|
|
*
|
|
* @var bool
|
|
*/
|
|
private $pivotTables = false;
|
|
|
|
/**
|
|
* Select unlocked cells.
|
|
*
|
|
* @var bool
|
|
*/
|
|
private $selectUnlockedCells = false;
|
|
|
|
/**
|
|
* Hashed password.
|
|
*
|
|
* @var string
|
|
*/
|
|
private $password = '';
|
|
|
|
/**
|
|
* Algorithm name.
|
|
*
|
|
* @var string
|
|
*/
|
|
private $algorithm = '';
|
|
|
|
/**
|
|
* Salt value.
|
|
*
|
|
* @var string
|
|
*/
|
|
private $salt = '';
|
|
|
|
/**
|
|
* Spin count.
|
|
*
|
|
* @var int
|
|
*/
|
|
private $spinCount = 10000;
|
|
|
|
/**
|
|
* Create a new Protection.
|
|
*/
|
|
public function __construct()
|
|
{
|
|
}
|
|
|
|
/**
|
|
* Is some sort of protection enabled?
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function isProtectionEnabled()
|
|
{
|
|
return $this->sheet ||
|
|
$this->objects ||
|
|
$this->scenarios ||
|
|
$this->formatCells ||
|
|
$this->formatColumns ||
|
|
$this->formatRows ||
|
|
$this->insertColumns ||
|
|
$this->insertRows ||
|
|
$this->insertHyperlinks ||
|
|
$this->deleteColumns ||
|
|
$this->deleteRows ||
|
|
$this->selectLockedCells ||
|
|
$this->sort ||
|
|
$this->autoFilter ||
|
|
$this->pivotTables ||
|
|
$this->selectUnlockedCells;
|
|
}
|
|
|
|
/**
|
|
* Get Sheet.
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function getSheet()
|
|
{
|
|
return $this->sheet;
|
|
}
|
|
|
|
/**
|
|
* Set Sheet.
|
|
*
|
|
* @param bool $pValue
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function setSheet($pValue)
|
|
{
|
|
$this->sheet = $pValue;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get Objects.
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function getObjects()
|
|
{
|
|
return $this->objects;
|
|
}
|
|
|
|
/**
|
|
* Set Objects.
|
|
*
|
|
* @param bool $pValue
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function setObjects($pValue)
|
|
{
|
|
$this->objects = $pValue;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get Scenarios.
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function getScenarios()
|
|
{
|
|
return $this->scenarios;
|
|
}
|
|
|
|
/**
|
|
* Set Scenarios.
|
|
*
|
|
* @param bool $pValue
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function setScenarios($pValue)
|
|
{
|
|
$this->scenarios = $pValue;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get FormatCells.
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function getFormatCells()
|
|
{
|
|
return $this->formatCells;
|
|
}
|
|
|
|
/**
|
|
* Set FormatCells.
|
|
*
|
|
* @param bool $pValue
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function setFormatCells($pValue)
|
|
{
|
|
$this->formatCells = $pValue;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get FormatColumns.
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function getFormatColumns()
|
|
{
|
|
return $this->formatColumns;
|
|
}
|
|
|
|
/**
|
|
* Set FormatColumns.
|
|
*
|
|
* @param bool $pValue
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function setFormatColumns($pValue)
|
|
{
|
|
$this->formatColumns = $pValue;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get FormatRows.
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function getFormatRows()
|
|
{
|
|
return $this->formatRows;
|
|
}
|
|
|
|
/**
|
|
* Set FormatRows.
|
|
*
|
|
* @param bool $pValue
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function setFormatRows($pValue)
|
|
{
|
|
$this->formatRows = $pValue;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get InsertColumns.
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function getInsertColumns()
|
|
{
|
|
return $this->insertColumns;
|
|
}
|
|
|
|
/**
|
|
* Set InsertColumns.
|
|
*
|
|
* @param bool $pValue
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function setInsertColumns($pValue)
|
|
{
|
|
$this->insertColumns = $pValue;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get InsertRows.
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function getInsertRows()
|
|
{
|
|
return $this->insertRows;
|
|
}
|
|
|
|
/**
|
|
* Set InsertRows.
|
|
*
|
|
* @param bool $pValue
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function setInsertRows($pValue)
|
|
{
|
|
$this->insertRows = $pValue;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get InsertHyperlinks.
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function getInsertHyperlinks()
|
|
{
|
|
return $this->insertHyperlinks;
|
|
}
|
|
|
|
/**
|
|
* Set InsertHyperlinks.
|
|
*
|
|
* @param bool $pValue
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function setInsertHyperlinks($pValue)
|
|
{
|
|
$this->insertHyperlinks = $pValue;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get DeleteColumns.
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function getDeleteColumns()
|
|
{
|
|
return $this->deleteColumns;
|
|
}
|
|
|
|
/**
|
|
* Set DeleteColumns.
|
|
*
|
|
* @param bool $pValue
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function setDeleteColumns($pValue)
|
|
{
|
|
$this->deleteColumns = $pValue;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get DeleteRows.
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function getDeleteRows()
|
|
{
|
|
return $this->deleteRows;
|
|
}
|
|
|
|
/**
|
|
* Set DeleteRows.
|
|
*
|
|
* @param bool $pValue
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function setDeleteRows($pValue)
|
|
{
|
|
$this->deleteRows = $pValue;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get SelectLockedCells.
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function getSelectLockedCells()
|
|
{
|
|
return $this->selectLockedCells;
|
|
}
|
|
|
|
/**
|
|
* Set SelectLockedCells.
|
|
*
|
|
* @param bool $pValue
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function setSelectLockedCells($pValue)
|
|
{
|
|
$this->selectLockedCells = $pValue;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get Sort.
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function getSort()
|
|
{
|
|
return $this->sort;
|
|
}
|
|
|
|
/**
|
|
* Set Sort.
|
|
*
|
|
* @param bool $pValue
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function setSort($pValue)
|
|
{
|
|
$this->sort = $pValue;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get AutoFilter.
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function getAutoFilter()
|
|
{
|
|
return $this->autoFilter;
|
|
}
|
|
|
|
/**
|
|
* Set AutoFilter.
|
|
*
|
|
* @param bool $pValue
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function setAutoFilter($pValue)
|
|
{
|
|
$this->autoFilter = $pValue;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get PivotTables.
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function getPivotTables()
|
|
{
|
|
return $this->pivotTables;
|
|
}
|
|
|
|
/**
|
|
* Set PivotTables.
|
|
*
|
|
* @param bool $pValue
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function setPivotTables($pValue)
|
|
{
|
|
$this->pivotTables = $pValue;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get SelectUnlockedCells.
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function getSelectUnlockedCells()
|
|
{
|
|
return $this->selectUnlockedCells;
|
|
}
|
|
|
|
/**
|
|
* Set SelectUnlockedCells.
|
|
*
|
|
* @param bool $pValue
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function setSelectUnlockedCells($pValue)
|
|
{
|
|
$this->selectUnlockedCells = $pValue;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get hashed password.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function getPassword()
|
|
{
|
|
return $this->password;
|
|
}
|
|
|
|
/**
|
|
* Set Password.
|
|
*
|
|
* @param string $pValue
|
|
* @param bool $pAlreadyHashed If the password has already been hashed, set this to true
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function setPassword($pValue, $pAlreadyHashed = false)
|
|
{
|
|
if (!$pAlreadyHashed) {
|
|
$salt = $this->generateSalt();
|
|
$this->setSalt($salt);
|
|
$pValue = PasswordHasher::hashPassword($pValue, $this->getAlgorithm(), $this->getSalt(), $this->getSpinCount());
|
|
}
|
|
|
|
$this->password = $pValue;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Create a pseudorandom string.
|
|
*/
|
|
private function generateSalt(): string
|
|
{
|
|
return base64_encode(random_bytes(16));
|
|
}
|
|
|
|
/**
|
|
* Get algorithm name.
|
|
*/
|
|
public function getAlgorithm(): string
|
|
{
|
|
return $this->algorithm;
|
|
}
|
|
|
|
/**
|
|
* Set algorithm name.
|
|
*/
|
|
public function setAlgorithm(string $algorithm): void
|
|
{
|
|
$this->algorithm = $algorithm;
|
|
}
|
|
|
|
/**
|
|
* Get salt value.
|
|
*/
|
|
public function getSalt(): string
|
|
{
|
|
return $this->salt;
|
|
}
|
|
|
|
/**
|
|
* Set salt value.
|
|
*/
|
|
public function setSalt(string $salt): void
|
|
{
|
|
$this->salt = $salt;
|
|
}
|
|
|
|
/**
|
|
* Get spin count.
|
|
*/
|
|
public function getSpinCount(): int
|
|
{
|
|
return $this->spinCount;
|
|
}
|
|
|
|
/**
|
|
* Set spin count.
|
|
*/
|
|
public function setSpinCount(int $spinCount): void
|
|
{
|
|
$this->spinCount = $spinCount;
|
|
}
|
|
|
|
/**
|
|
* Verify that the given non-hashed password can "unlock" the protection.
|
|
*/
|
|
public function verify(string $password): bool
|
|
{
|
|
if (!$this->isProtectionEnabled()) {
|
|
return true;
|
|
}
|
|
|
|
$hash = PasswordHasher::hashPassword($password, $this->getAlgorithm(), $this->getSalt(), $this->getSpinCount());
|
|
|
|
return $this->getPassword() === $hash;
|
|
}
|
|
|
|
/**
|
|
* Implement PHP __clone to create a deep clone, not just a shallow copy.
|
|
*/
|
|
public function __clone()
|
|
{
|
|
$vars = get_object_vars($this);
|
|
foreach ($vars as $key => $value) {
|
|
if (is_object($value)) {
|
|
$this->$key = clone $value;
|
|
} else {
|
|
$this->$key = $value;
|
|
}
|
|
}
|
|
}
|
|
}
|