Version 4.1.2

This commit is contained in:
Neo committed 2025-12-19 05:32:19 -08:00
1 parent 3ba79295ee
commit 28bd025b35
1131 files changed
+63658 -20579

No files matched your search

+117
View File
@@ -0,0 +1,117 @@
<?php
/**
* @brief Archive Class
* @author <a href='http://www.invisionpower.com'>Invision Power Services, Inc.</a>
* @copyright (c) 2001 - SVN_YYYY Invision Power Services, Inc.
* @license http://www.invisionpower.com/legal/standards/
* @package IPS Social Suite
* @since 28 Jul 2015
* @version SVN_VERSION_NUMBER
*/
namespace IPS;
/* To prevent PHP errors (extending class does not exist) revealing path */
if ( !defined( '\IPS\SUITE_UNIQUE_KEY' ) )
{
header( ( isset( $_SERVER['SERVER_PROTOCOL'] ) ? $_SERVER['SERVER_PROTOCOL'] : 'HTTP/1.0' ) . ' 403 Forbidden' );
exit;
}
/**
* @brief Archive Class
*/
abstract class _Archive
{
/**
* @brief The root folder name which should be ignored (with trailing slash)
*/
protected $containerName = '';
/**
* Create object from local file
*
* @param string $path Path to archive file
* @param string $containerName The root folder name which should be ignored (with trailing slash)
* @return \IPS\Archive
*/
public static function fromLocalFile( $path, $containerName = '' )
{
return new static;
}
/**
* Number of files
*
* @return int
*/
abstract public function numberOfFiles();
/**
* Get file name
*
* @param int $i File number
* @return string
* @throws \OutOfRangeException
*/
abstract public function getFileName( $i );
/**
* Get file contents
*
* @param int $i File number
* @return string
* @throws \OutOfRangeException
*/
abstract public function getFileContents( $i );
/**
* Extract
*
* @param string $destination Destination directory
* @param int|NULL $limit Number of files to extract
* @param int $offset Offset
* @retrun bool If true, all files were extracted, if false, there is more to extract
*/
public function extract( $destination, $limit=NULL, $offset=0 )
{
$done = 0;
while ( $limit === NULL or $limit > $done ) // OutOfRangeException will break if $limit is NULL
{
try
{
$path = $this->getFileName( $offset + $done );
if ( $path and mb_substr( $path, -1 ) !== '/' )
{
/* Create a directory if needed */
$dir = dirname( $path );
if ( !is_dir( $dir ) )
{
@mkdir( $dir, \IPS\FOLDER_PERMISSION_NO_WRITE );
}
/* Write contents */
$contents = $this->getFileContents( $offset + $done );
$fh = @\fopen( $destination . '/' . $path, 'w+' );
if ( $fh === FALSE )
{
throw new \IPS\Archive\Exception( '', \IPS\Archive\Exception::COULD_NOT_WRITE );
}
if ( @\fwrite( $fh, $contents ) === FALSE )
{
throw new \IPS\Archive\Exception( '', \IPS\Archive\Exception::COULD_NOT_WRITE );
}
@\fclose( $fh );
}
$done++;
}
catch ( \OutOfRangeException $e )
{
return TRUE;
}
}
return FALSE;
}
}
+28
View File
@@ -0,0 +1,28 @@
<?php
/**
* @brief Archive Exception Class
* @author <a href='http://www.invisionpower.com'>Invision Power Services, Inc.</a>
* @copyright (c) 2001 - SVN_YYYY Invision Power Services, Inc.
* @license http://www.invisionpower.com/legal/standards/
* @package IPS Social Suite
* @since 28 Jul 2015
* @version SVN_VERSION_NUMBER
*/
namespace IPS\Archive;
/* To prevent PHP errors (extending class does not exist) revealing path */
if ( !defined( '\IPS\SUITE_UNIQUE_KEY' ) )
{
header( ( isset( $_SERVER['SERVER_PROTOCOL'] ) ? $_SERVER['SERVER_PROTOCOL'] : 'HTTP/1.0' ) . ' 403 Forbidden' );
exit;
}
/**
* Login Exception Class
*/
class _Exception extends \RuntimeException
{
const COULD_NOT_OPEN = 1;
const COULD_NOT_WRITE = 2;
}
+105
View File
@@ -0,0 +1,105 @@
<?php
/**
* @brief PclZip Zip Class
* @author <a href='http://www.invisionpower.com'>Invision Power Services, Inc.</a>
* @copyright (c) 2001 - SVN_YYYY Invision Power Services, Inc.
* @license http://www.invisionpower.com/legal/standards/
* @package IPS Social Suite
* @since 28 Jul 2015
* @version SVN_VERSION_NUMBER
*/
namespace IPS\Archive\Zip;
/* To prevent PHP errors (extending class does not exist) revealing path */
if ( !defined( '\IPS\SUITE_UNIQUE_KEY' ) )
{
header( ( isset( $_SERVER['SERVER_PROTOCOL'] ) ? $_SERVER['SERVER_PROTOCOL'] : 'HTTP/1.0' ) . ' 403 Forbidden' );
exit;
}
require_once( \IPS\ROOT_PATH . '/system/3rd_party/pclzip/pclzip.lib.php' );
/**
* @brief PclZip Zip Class
*/
class _PclZip extends \IPS\Archive\Zip
{
/**
* @brief PclZip Object
*/
protected $zipArchive;
/**
* @brief Files
*/
protected $files;
/**
* Create object from local file
*
* @param string $path Path to archive file
* @return \IPS\Archive
*/
public static function _fromLocalFile( $path )
{
$object = new static;
$object->zipArchive = new \PclZip( $path );
return $object;
}
/**
* Number of files
*
* @return int
*/
public function numberOfFiles()
{
$properties = $this->zipArchive->properties();
return $properties['nb'];
}
/**
* Get file name
*
* @param int $i File number
* @return string
* @throws \RuntimeException
* @throws \OutOfRangeException
*/
public function getFileName( $i )
{
if ( $this->files === NULL )
{
$this->files = $this->zipArchive->listContent();
}
/* pclZip returns 0 on an unrecoverable failure */
if ( $this->files === 0 )
{
throw new \RuntimeException;
}
if ( isset( $this->files[ $i ] ) )
{
return mb_substr( $this->files[ $i ]['filename'], mb_strlen( $this->containerName ) );
}
else
{
throw new \OutOfRangeException;
}
}
/**
* Get file contents
*
* @param int $i File number
* @return string
* @throws \OutOfRangeException
*/
public function getFileContents( $i )
{
$content = $this->zipArchive->extractByIndex( $i, \PCLZIP_OPT_EXTRACT_AS_STRING );
return $content[0]['content'];
}
}
+47
View File
@@ -0,0 +1,47 @@
<?php
/**
* @brief Zip Archive Class
* @author <a href='http://www.invisionpower.com'>Invision Power Services, Inc.</a>
* @copyright (c) 2001 - SVN_YYYY Invision Power Services, Inc.
* @license http://www.invisionpower.com/legal/standards/
* @package IPS Social Suite
* @since 28 Jul 2015
* @version SVN_VERSION_NUMBER
*/
namespace IPS\Archive;
/* To prevent PHP errors (extending class does not exist) revealing path */
if ( !defined( '\IPS\SUITE_UNIQUE_KEY' ) )
{
header( ( isset( $_SERVER['SERVER_PROTOCOL'] ) ? $_SERVER['SERVER_PROTOCOL'] : 'HTTP/1.0' ) . ' 403 Forbidden' );
exit;
}
/**
* @brief Zip Archive Class
*/
abstract class _Zip extends \IPS\Archive
{
/**
* Create object from local file
*
* @param string $path Path to archive file
* @param string $containerName The root folder name which should be ignored (with trailing slash)
* @return \IPS\Archive
*/
public static function fromLocalFile( $path, $containerName = '' )
{
if ( extension_loaded( 'Zip' ) )
{
$object = Zip\ZipArchive::_fromLocalFile( $path );
}
else
{
$object = Zip\PclZip::_fromLocalFile( $path );
}
$object->containerName = $containerName;
return $object;
}
}
+88
View File
@@ -0,0 +1,88 @@
<?php
/**
* @brief ZipArchive Zip Class
* @author <a href='http://www.invisionpower.com'>Invision Power Services, Inc.</a>
* @copyright (c) 2001 - SVN_YYYY Invision Power Services, Inc.
* @license http://www.invisionpower.com/legal/standards/
* @package IPS Social Suite
* @since 28 Jul 2015
* @version SVN_VERSION_NUMBER
*/
namespace IPS\Archive\Zip;
/* To prevent PHP errors (extending class does not exist) revealing path */
if ( !defined( '\IPS\SUITE_UNIQUE_KEY' ) )
{
header( ( isset( $_SERVER['SERVER_PROTOCOL'] ) ? $_SERVER['SERVER_PROTOCOL'] : 'HTTP/1.0' ) . ' 403 Forbidden' );
exit;
}
/**
* @brief ZipArchive Zip Class
*/
class _ZipArchive extends \IPS\Archive\Zip
{
/**
* @brief ZipArchive Object
*/
protected $zipArchive;
/**
* Create object from local file
*
* @param string $path Path to archive file
* @return \IPS\Archive
*/
public static function _fromLocalFile( $path )
{
$object = new static;
$object->zipArchive = new \ZipArchive;
$open = $object->zipArchive->open( $path );
if ( $open !== TRUE )
{
throw new \IPS\Archive\Exception( $open, \IPS\Archive\Exception::COULD_NOT_OPEN );
}
return $object;
}
/**
* Number of files
*
* @return int
*/
public function numberOfFiles()
{
return $this->zipArchive->numFiles;
}
/**
* Get file name
*
* @param int $i File number
* @return string
* @throws \OutOfRangeException
*/
public function getFileName( $i )
{
$info = $this->zipArchive->statIndex( $i );
if ( $info === FALSE )
{
throw new \OutOfRangeException;
}
return mb_substr( $info['name'], mb_strlen( $this->containerName ) );
}
/**
* Get file contents
*
* @param int $i File number
* @return string
* @throws \OutOfRangeException
*/
public function getFileContents( $i )
{
return $this->zipArchive->getFromIndex( $i );
}
}