Three dependencies updated and moved to vendor directory:

PHPMailer (upgraded to v6 - more testing required) JsShink Mysqldump-php
2025-08-30 09:39:55 +02:00 · 2020-02-29 11:56:05 -08:00
parent a5193f2850
commit 1925ce5264
89 changed files with 7112 additions and 2371 deletions
--- a/e107_handlers/vendor/ifsnop/mysqldump-php/README.md
+++ b/e107_handlers/vendor/ifsnop/mysqldump-php/README.md
@@ -0,0 +1,351 @@
+MySQLDump - PHP
+=========
+
+[Requirements](https://github.com/ifsnop/mysqldump-php#requirements) |
+[Installing](https://github.com/ifsnop/mysqldump-php#installing) |
+[Getting started](https://github.com/ifsnop/mysqldump-php#getting-started) |
+[API](https://github.com/ifsnop/mysqldump-php#constructor-and-default-parameters) |
+[Settings](https://github.com/ifsnop/mysqldump-php#dump-settings) |
+[PDO Settings](https://github.com/ifsnop/mysqldump-php#pdo-settings) |
+[TODO](https://github.com/ifsnop/mysqldump-php#todo) |
+[License](https://github.com/ifsnop/mysqldump-php#license) |
+[Credits](https://github.com/ifsnop/mysqldump-php#credits)
+
+[![Build Status](https://travis-ci.org/ifsnop/mysqldump-php.svg?branch=devel)](https://travis-ci.org/ifsnop/mysqldump-php)
+[![Total Downloads](https://poser.pugx.org/ifsnop/mysqldump-php/downloads)](https://packagist.org/packages/ifsnop/mysqldump-php)
+[![Monthly Downloads](https://poser.pugx.org/ifsnop/mysqldump-php/d/monthly)](https://packagist.org/packages/ifsnop/mysqldump-php)
+[![Daily Downloads](https://poser.pugx.org/ifsnop/mysqldump-php/d/daily)](https://packagist.org/packages/ifsnop/mysqldump-php)
+[![Scrutinizer Quality Score](https://scrutinizer-ci.com/g/ifsnop/mysqldump-php/badges/quality-score.png?s=d02891e196a3ca1298619032a538ce8ae8cafd2b)](https://scrutinizer-ci.com/g/ifsnop/mysqldump-php/)
+[![Latest Stable Version](https://poser.pugx.org/ifsnop/mysqldump-php/v/stable.png)](https://packagist.org/packages/ifsnop/mysqldump-php)
+
+This is a php version of mysqldump cli that comes with MySQL, without dependencies, output compression and sane defaults.
+
+Out of the box, MySQLDump-PHP supports backing up table structures, the data itself, views, triggers and events.
+
+MySQLDump-PHP is the only library that supports:
+* output binary blobs as hex.
+* resolves view dependencies (using Stand-In tables).
+* output compared against original mysqldump. Linked to travis-ci testing system (testing from php 5.3 to 7.1 & hhvm)
+* dumps stored routines (functions and procedures).
+* dumps events.
+* does extended-insert and/or complete-insert.
+* supports virtual columns from MySQL 5.7.
+* does insert-ignore, like a REPLACE but ignoring errors if a duplicate key exists.
+* modifying data from database on-the-fly when dumping, using hooks.
+* can save directly to google cloud storage over a compressed stream wrapper (GZIPSTREAM).
+
+## Important
+
+From version 2.0, connections to database are made using the standard DSN, documented in [PDO connection string](https://secure.php.net/manual/en/ref.pdo-mysql.connection.php).
+
+## Requirements
+
+- PHP 5.3.0 or newer
+- MySQL 4.1.0 or newer
+- [PDO](https://secure.php.net/pdo)
+
+## Installing
+
+Using [Composer](https://getcomposer.org/):
+
+```
+$ composer require ifsnop/mysqldump-php
+
+```
+
+Using [Curl](https://curl.haxx.se/) to always download and decompress the latest release:
+
+```
+$ curl --silent --location https://api.github.com/repos/ifsnop/mysqldump-php/releases | grep -i tarball_url | head -n 1 | cut -d '"' -f 4 | xargs curl --location --silent | tar xvz
+```
+
+## Getting started
+
+With [Autoloader](https://www.php-fig.org/psr/psr-4/)/[Composer](https://getcomposer.org):
+
+```php
+<?php
+
+use Ifsnop\Mysqldump as IMysqldump;
+
+try {
+    $dump = new IMysqldump\Mysqldump('mysql:host=localhost;dbname=testdb', 'username', 'password');
+    $dump->start('storage/work/dump.sql');
+} catch (\Exception $e) {
+    echo 'mysqldump-php error: ' . $e->getMessage();
+}
+```
+
+Plain old PHP:
+
+```php
+<?php
+
+    include_once(dirname(__FILE__) . '/mysqldump-php-2.0.0/src/Ifsnop/Mysqldump/Mysqldump.php');
+    $dump = new Ifsnop\Mysqldump\Mysqldump('mysql:host=localhost;dbname=testdb', 'username', 'password');
+    $dump->start('storage/work/dump.sql');
+```
+
+Refer to the [wiki](https://github.com/ifsnop/mysqldump-php/wiki/Full-usage-example) for some examples and a comparision between mysqldump and mysqldump-php dumps.
+
+## Changing values when exporting
+You can register a callable that will be used to transform values during the export. An example use-case for this is removing sensitive data from database dumps:
+
+```php
+$dumper = new IMysqldump\Mysqldump('mysql:host=localhost;dbname=testdb', 'username', 'password');
+
+$dumper->setTransformColumnValueHook(function ($tableName, $colName, $colValue) {
+    if ($colName === 'social_security_number') {
+        return (string) rand(1000000, 9999999);
+    }
+
+    return $colValue;
+});
+
+$dumper->start('storage/work/dump.sql');
+```
+
+## Table specific export conditions
+You can register table specific 'where' clauses to limit data on a per table basis.  These override the default `where` dump setting:
+
+```php
+$dumper = new IMysqldump\Mysqldump('mysql:host=localhost;dbname=testdb', 'username', 'password');
+
+$dumper->setTableWheres(array(
+    'users' => 'date_registered > NOW() - INTERVAL 3 MONTH AND deleted=0',
+    'logs' => 'date_logged > NOW() - INTERVAL 1 DAY',
+    'posts' => 'isLive=1'
+));
+```
+
+## Table specific export limits
+You can register table specific 'limits' to limit the returned rows on a per table basis:
+
+```php
+$dumper = new IMysqldump\Mysqldump('mysql:host=localhost;dbname=testdb', 'username', 'password');
+
+$dumper->setTableLimits(array(
+    'users' => 300,
+    'logs' => 50,
+    'posts' => 10
+));
+```
+
+## Constructor and default parameters
+```php
+/**
+ * Constructor of Mysqldump. Note that in the case of an SQLite database
+ * connection, the filename must be in the $db parameter.
+ *
+ * @param string $dsn        PDO DSN connection string
+ * @param string $user       SQL account username
+ * @param string $pass       SQL account password
+ * @param array  $dumpSettings SQL database settings
+ * @param array  $pdoSettings  PDO configured attributes
+ */
+public function __construct(
+    $dsn = '',
+    $user = '',
+    $pass = '',
+    $dumpSettings = array(),
+    $pdoSettings = array()
+)
+
+$dumpSettingsDefault = array(
+    'include-tables' => array(),
+    'exclude-tables' => array(),
+    'compress' => Mysqldump::NONE,
+    'init_commands' => array(),
+    'no-data' => array(),
+    'reset-auto-increment' => false,
+    'add-drop-database' => false,
+    'add-drop-table' => false,
+    'add-drop-trigger' => true,
+    'add-locks' => true,
+    'complete-insert' => false,
+    'databases' => false,
+    'default-character-set' => Mysqldump::UTF8,
+    'disable-keys' => true,
+    'extended-insert' => true,
+    'events' => false,
+    'hex-blob' => true, /* faster than escaped content */
+    'insert-ignore' => false,
+    'net_buffer_length' => self::MAXLINESIZE,
+    'no-autocommit' => true,
+    'no-create-info' => false,
+    'lock-tables' => true,
+    'routines' => false,
+    'single-transaction' => true,
+    'skip-triggers' => false,
+    'skip-tz-utc' => false,
+    'skip-comments' => false,
+    'skip-dump-date' => false,
+    'skip-definer' => false,
+    'where' => '',
+    /* deprecated */
+    'disable-foreign-keys-check' => true
+);
+
+$pdoSettingsDefaults = array(
+    PDO::ATTR_PERSISTENT => true,
+    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
+    PDO::MYSQL_ATTR_USE_BUFFERED_QUERY => false
+);
+
+// missing settings in constructor will be replaced by default options
+$this->_pdoSettings = self::array_replace_recursive($pdoSettingsDefault, $pdoSettings);
+$this->_dumpSettings = self::array_replace_recursive($dumpSettingsDefault, $dumpSettings);
+```
+
+## Dump Settings
+
+- **include-tables**
+  - Only include these tables (array of table names), include all if empty
+- **exclude-tables**
+  - Exclude these tables (array of table names), include all if empty, supports regexps
+- **compress**
+  - Gzip, Bzip2, None.
+  - Could be specified using the declared consts: IMysqldump\Mysqldump::GZIP, IMysqldump\Mysqldump::BZIP2 or IMysqldump\Mysqldump::NONE
+- **reset-auto-increment**
+  - Removes the AUTO_INCREMENT option from the database definition
+  - Useful when used with no-data, so when db is recreated, it will start from 1 instead of using an old value
+- **add-drop-database**
+  - https://dev.mysql.com/doc/refman/5.1/en/mysqldump.html#option_mysqldump_add-drop-database
+- **add-drop-table**
+  - https://dev.mysql.com/doc/refman/5.1/en/mysqldump.html#option_mysqldump_add-drop-table
+- **add-drop-triggers**
+  - https://dev.mysql.com/doc/refman/5.1/en/mysqldump.html#option_mysqldump_add-drop-trigger
+- **add-locks**
+  - https://dev.mysql.com/doc/refman/5.1/en/mysqldump.html#option_mysqldump_add-locks
+- **complete-insert**
+  - https://dev.mysql.com/doc/refman/5.1/en/mysqldump.html#option_mysqldump_complete-insert
+- **databases**
+  - https://dev.mysql.com/doc/refman/5.1/en/mysqldump.html#option_mysqldump_databases
+- **default-character-set**
+  - utf8 (default, compatible option), utf8mb4 (for full utf8 compliance)
+  - Could be specified using the declared consts: IMysqldump\Mysqldump::UTF8 or IMysqldump\Mysqldump::UTF8MB4BZIP2
+  - https://dev.mysql.com/doc/refman/5.5/en/charset-unicode-utf8mb4.html
+  - https://mathiasbynens.be/notes/mysql-utf8mb4
+- **disable-keys**
+  - https://dev.mysql.com/doc/refman/5.1/en/mysqldump.html#option_mysqldump_disable-keys
+- **events**
+  - https://dev.mysql.com/doc/refman/5.7/en/mysqldump.html#option_mysqldump_events
+- **extended-insert**
+  - https://dev.mysql.com/doc/refman/5.1/en/mysqldump.html#option_mysqldump_extended-insert
+- **hex-blob**
+  - https://dev.mysql.com/doc/refman/5.1/en/mysqldump.html#option_mysqldump_hex-blob
+- **insert-ignore**
+  - https://dev.mysql.com/doc/refman/5.7/en/mysqldump.html#option_mysqldump_insert-ignore
+- **lock-tables**
+  - https://dev.mysql.com/doc/refman/5.1/en/mysqldump.html#option_mysqldump_lock-tables
+- **net_buffer_length**
+  - https://dev.mysql.com/doc/refman/5.7/en/mysqldump.html#option_mysqldump_net_buffer_length
+- **no-autocommit**
+  - Option to disable autocommit (faster inserts, no problems with index keys)
+  - https://dev.mysql.com/doc/refman/4.1/en/commit.html
+- **no-create-info**
+  - https://dev.mysql.com/doc/refman/5.1/en/mysqldump.html#option_mysqldump_no-create-info
+- **no-data**
+  - https://dev.mysql.com/doc/refman/5.1/en/mysqldump.html#option_mysqldump_no-data
+  - Do not dump data for these tables (array of table names), support regexps, `true` to ignore all tables
+- **routines**
+  - https://dev.mysql.com/doc/refman/5.1/en/mysqldump.html#option_mysqldump_routines
+- **single-transaction**
+  - https://dev.mysql.com/doc/refman/5.1/en/mysqldump.html#option_mysqldump_single-transaction
+- **skip-comments**
+  - https://dev.mysql.com/doc/refman/5.1/en/mysqldump.html#option_mysqldump_comments
+- **skip-dump-date**
+  - https://dev.mysql.com/doc/refman/5.1/en/mysqldump.html#option_mysqldump_dump-date
+- **skip-triggers**
+  - https://dev.mysql.com/doc/refman/5.1/en/mysqldump.html#option_mysqldump_triggers
+- **skip-tz-utc**
+  - https://dev.mysql.com/doc/refman/5.1/en/mysqldump.html#option_mysqldump_tz-utc
+- **skip-definer**
+  - https://dev.mysql.com/doc/refman/5.7/en/mysqlpump.html#option_mysqlpump_skip-definer
+- **where**
+  - https://dev.mysql.com/doc/refman/5.1/en/mysqldump.html#option_mysqldump_where
+
+The following options are now enabled by default, and there is no way to disable them since
+they should always be used.
+
+- **disable-foreign-keys-check**
+  - https://dev.mysql.com/doc/refman/5.5/en/optimizing-innodb-bulk-data-loading.html
+
+## PDO Settings
+
+- **PDO::ATTR_PERSISTENT**
+- **PDO::ATTR_ERRMODE**
+- **PDO::MYSQL_ATTR_INIT_COMMAND**
+- **PDO::MYSQL_ATTR_USE_BUFFERED_QUERY**
+  - https://secure.php.net/manual/en/ref.pdo-mysql.php
+  - https://stackoverflow.com/questions/13728106/unexpectedly-hitting-php-memory-limit-with-a-single-pdo-query/13729745#13729745
+  - https://secure.php.net/manual/en/mysqlinfo.concepts.buffering.php
+
+## Errors
+
+To dump a database, you need the following privileges :
+
+- **SELECT**
+  - In order to dump table structures and data.
+- **SHOW VIEW**
+  - If any databases has views, else you will get an error.
+- **TRIGGER**
+  - If any table has one or more triggers.
+- **LOCK TABLES**
+  - If "lock tables" option was enabled.
+
+Use **SHOW GRANTS FOR user@host;** to know what privileges user has. See the following link for more information:
+
+[Which are the minimum privileges required to get a backup of a MySQL database schema?](https://dba.stackexchange.com/questions/55546/which-are-the-minimum-privileges-required-to-get-a-backup-of-a-mysql-database-sc/55572#55572)
+
+## Tests
+
+Current code for testing is an ugly hack. Probably there are much better ways
+of doing them using PHPUnit, so PR's are welcomed. The testing script creates
+and populates a database using all possible datatypes. Then it exports it
+using both mysqldump-php and mysqldump, and compares the output. Only if
+it is identical tests are OK. After [this](https://github.com/ifsnop/mysqldump-php/commit/8496fbb1b26dde404804bc8865ec32044da5b813)
+commit, some test are performed using phpunit.
+
+Some tests are skipped if mysql server doesn't support them.
+
+A couple of tests are only comparing between original sql code and
+mysqldump-php generated sql, because some options are not available in
+mysqldump.
+
+## Bugs (from mysqldump, not from mysqldump-php)
+
+After [this](https://bugs.mysql.com/bug.php?id=80150) bug report, a new
+one has been introduced. _binary is appended also when hex-blob option is
+used, if the value is empty.
+
+## Backporting
+
+mysqldump-php is not backwards compatible with php 5.2 because we it uses
+namespaces. However, it could be trivially fixed if needed.
+
+## Todo
+
+Write more tests, test with mariadb also.
+
+## Contributing
+
+Format all code to PHP-FIG standards.
+https://www.php-fig.org/
+
+## License
+
+This project is open-sourced software licensed under the [GPL license](https://www.gnu.org/copyleft/gpl.html)
+
+## Credits
+
+After more than 8 years, there is barely anything left from the original source code, but:
+
+Originally based on James Elliott's script from 2009.
+https://code.google.com/archive/p/db-mysqldump/
+
+Adapted and extended by Michael J. Calkins.
+https://github.com/clouddueling
+
+Currently maintained, developed and improved by Diego Torres.
+https://github.com/ifsnop