mirror/Arsse
1
1
Fork 0
mirror of https://code.mensbeam.com/MensBeam/Arsse.git synced 2024-12-22 13:12:41 +00:00
Code Issues Activity
Arsse/lib/AbstractException.php

152 lines
8 KiB
PHP
Raw Normal View History

Moved base exception code to abstract class This allows differentiating specific and general exceptions in tests; a library-wide trap would have to trap AbstractException
2017-02-11 19:56:02 +00:00
<?php
Added per-file legal boilerplate Includes PHPDoc license tag in the file-level block with accompanying copyright notice. Also added an AUTHORS file on the off chance of outside contributions
2017-11-17 01:23:18 +00:00
/** @license MIT
* Copyright 2017 J. King, Dustin Wilson et al.
* See LICENSE and AUTHORS files for details */
Moved base exception code to abstract class This allows differentiating specific and general exceptions in tests; a library-wide trap would have to trap AbstractException
2017-02-11 19:56:02 +00:00
declare(strict_types=1);
Apply new rules
2021-04-14 15:17:01 +00:00
Changed "NewsSync" to "Arsse"
2017-03-28 04:12:12 +00:00
namespace JKingWeb\Arsse;
Moved base exception code to abstract class This allows differentiating specific and general exceptions in tests; a library-wide trap would have to trap AbstractException
2017-02-11 19:56:02 +00:00
abstract class AbstractException extends \Exception {
Add class constant visibility
2020-03-01 23:32:01 +00:00
public const CODES = [
Make distinction between modified and marked for articles Also added various sets of fields to include when listing articles.
2017-11-17 22:52:00 +00:00
"Exception.uncoded" => -1,
Fix numerous bugs when adding or changing folders - Specifying a non-integer parent no longer silently casts to 0 or 1 - Specifying a folder ID of 0 now always converts to null automatically - Performing both a rename and move to root in the same operation no longer results in potential duplicates - Calling folderSetProperties with an empty data array no peforms an update; it now returns false before the update call - Modification timestamps are now actually updated when a folder is modified - Constraint violation exceptions triggered by code (rather than the database) now print a message - Renaming a folder or subscription to a non-string value (e.g. an array) throws an exception rather than silently casting - Added tests to better cover all the above - Centralized the normalization of integers and title strings into a new ValueInfo static class
2017-09-26 20:45:41 +00:00
"Exception.unknown" => 10000,
Change code and type of consantUnknown exception
2017-11-18 03:53:54 +00:00
"Exception.constantUnknown" => 10001,
Remove arbitrary search term limits; fixes #150
2019-03-02 18:53:43 +00:00
"Exception.arrayEmpty" => 10002,
Merge changes from master
2017-10-20 02:58:42 +00:00
"ExceptionType.strictFailure" => 10011,
"ExceptionType.typeUnknown" => 10012,
Prototype code to check for missing extensions This is useful in general, but will also provide clear error text if trying to fork without the posix or pcntl extensions
2021-07-03 14:23:24 +00:00
"Exception.extMissing" => 10021,
Fix numerous bugs when adding or changing folders - Specifying a non-integer parent no longer silently casts to 0 or 1 - Specifying a folder ID of 0 now always converts to null automatically - Performing both a rename and move to root in the same operation no longer results in potential duplicates - Calling folderSetProperties with an empty data array no peforms an update; it now returns false before the update call - Modification timestamps are now actually updated when a folder is modified - Constraint violation exceptions triggered by code (rather than the database) now print a message - Renaming a folder or subscription to a non-string value (e.g. an array) throws an exception rather than silently casting - Added tests to better cover all the above - Centralized the normalization of integers and title strings into a new ValueInfo static class
2017-09-26 20:45:41 +00:00
"Lang/Exception.defaultFileMissing" => 10101,
"Lang/Exception.fileMissing" => 10102,
"Lang/Exception.fileUnreadable" => 10103,
"Lang/Exception.fileCorrupt" => 10104,
"Lang/Exception.stringMissing" => 10105,
"Lang/Exception.stringInvalid" => 10106,
Validate configuration parameters on import, and other changes - Each parameter is checked for type and normalized - Interval strings are converted to DateInterval objects - Timeouts can be specified as interval strings - Most intervals can be null to signify infinity - Driver classes are checked that they implement the correct interface - Short driver names may be used, and are used by default - Helpful errors messages are printed in case of erroneous configuration Exporting is currently broken; this will be fixed in an upcoming commit
2019-01-21 03:40:49 +00:00
"Lang/Exception.dataInvalid" => 10107,
Fix numerous bugs when adding or changing folders - Specifying a non-integer parent no longer silently casts to 0 or 1 - Specifying a folder ID of 0 now always converts to null automatically - Performing both a rename and move to root in the same operation no longer results in potential duplicates - Calling folderSetProperties with an empty data array no peforms an update; it now returns false before the update call - Modification timestamps are now actually updated when a folder is modified - Constraint violation exceptions triggered by code (rather than the database) now print a message - Renaming a folder or subscription to a non-string value (e.g. an array) throws an exception rather than silently casting - Added tests to better cover all the above - Centralized the normalization of integers and title strings into a new ValueInfo static class
2017-09-26 20:45:41 +00:00
"Db/Exception.extMissing" => 10201,
"Db/Exception.fileMissing" => 10202,
"Db/Exception.fileUnusable" => 10203,
"Db/Exception.fileUnreadable" => 10204,
"Db/Exception.fileUnwritable" => 10205,
"Db/Exception.fileUncreatable" => 10206,
"Db/Exception.fileCorrupt" => 10207,
Handle PostgreSQL connection errors
2018-12-12 16:15:07 +00:00
"Db/Exception.connectionFailure" => 10208,
Fix numerous bugs when adding or changing folders - Specifying a non-integer parent no longer silently casts to 0 or 1 - Specifying a folder ID of 0 now always converts to null automatically - Performing both a rename and move to root in the same operation no longer results in potential duplicates - Calling folderSetProperties with an empty data array no peforms an update; it now returns false before the update call - Modification timestamps are now actually updated when a folder is modified - Constraint violation exceptions triggered by code (rather than the database) now print a message - Renaming a folder or subscription to a non-string value (e.g. an array) throws an exception rather than silently casting - Added tests to better cover all the above - Centralized the normalization of integers and title strings into a new ValueInfo static class
2017-09-26 20:45:41 +00:00
"Db/Exception.updateTooNew" => 10211,
"Db/Exception.updateManual" => 10212,
"Db/Exception.updateManualOnly" => 10213,
"Db/Exception.updateFileMissing" => 10214,
"Db/Exception.updateFileUnusable" => 10215,
"Db/Exception.updateFileUnreadable" => 10216,
"Db/Exception.updateFileError" => 10217,
"Db/Exception.updateFileIncomplete" => 10218,
"Db/Exception.paramTypeInvalid" => 10221,
"Db/Exception.paramTypeUnknown" => 10222,
"Db/Exception.paramTypeMissing" => 10223,
"Db/Exception.engineErrorGeneral" => 10224, // this symbol may have engine-specific duplicates to accomodate engine-specific error string construction
Make result sets single-use; change savewepoint exceptions - Result sets are now single-use; this is required for PDO drivers (PDO result sets are not rewindable) - Change savepoint exceptions to be simple database exceptions; codes remain the same
2017-11-06 03:13:44 +00:00
"Db/Exception.savepointStatusUnknown" => 10225,
"Db/Exception.savepointInvalid" => 10226,
"Db/Exception.savepointStale" => 10227,
Make distinction between modified and marked for articles Also added various sets of fields to include when listing articles.
2017-11-17 22:52:00 +00:00
"Db/Exception.resultReused" => 10228,
Work around various SQLite-related problems - WAL mode was not getting set properly - Queries using the PDO driver could fail because PDO sucks
2019-03-04 16:05:46 +00:00
"Db/ExceptionRetry.schemaChange" => 10229,
Imprement setting of filter rules
2021-01-14 17:42:33 +00:00
"Db/ExceptionInput.invalidValue" => 10230,
Fix numerous bugs when adding or changing folders - Specifying a non-integer parent no longer silently casts to 0 or 1 - Specifying a folder ID of 0 now always converts to null automatically - Performing both a rename and move to root in the same operation no longer results in potential duplicates - Calling folderSetProperties with an empty data array no peforms an update; it now returns false before the update call - Modification timestamps are now actually updated when a folder is modified - Constraint violation exceptions triggered by code (rather than the database) now print a message - Renaming a folder or subscription to a non-string value (e.g. an array) throws an exception rather than silently casting - Added tests to better cover all the above - Centralized the normalization of integers and title strings into a new ValueInfo static class
2017-09-26 20:45:41 +00:00
"Db/ExceptionInput.missing" => 10231,
"Db/ExceptionInput.whitespace" => 10232,
"Db/ExceptionInput.tooLong" => 10233,
"Db/ExceptionInput.tooShort" => 10234,
"Db/ExceptionInput.idMissing" => 10235,
"Db/ExceptionInput.constraintViolation" => 10236,
"Db/ExceptionInput.engineConstraintViolation" => 10236,
"Db/ExceptionInput.typeViolation" => 10237,
"Db/ExceptionInput.engineTypeViolation" => 10237,
"Db/ExceptionInput.circularDependence" => 10238,
"Db/ExceptionInput.subjectMissing" => 10239,
"Db/ExceptionTimeout.general" => 10241,
Proof-of-concept PDO MySQL driver - Configuration options were added - Non-transactional locking was added to the savepoint handlers - Tests were adjusted for MySQL's reserved words
2018-12-20 23:06:28 +00:00
"Db/ExceptionTimeout.logicalLock" => 10241,
Fix numerous bugs when adding or changing folders - Specifying a non-integer parent no longer silently casts to 0 or 1 - Specifying a folder ID of 0 now always converts to null automatically - Performing both a rename and move to root in the same operation no longer results in potential duplicates - Calling folderSetProperties with an empty data array no peforms an update; it now returns false before the update call - Modification timestamps are now actually updated when a folder is modified - Constraint violation exceptions triggered by code (rather than the database) now print a message - Renaming a folder or subscription to a non-string value (e.g. an array) throws an exception rather than silently casting - Added tests to better cover all the above - Centralized the normalization of integers and title strings into a new ValueInfo static class
2017-09-26 20:45:41 +00:00
"Conf/Exception.fileMissing" => 10301,
"Conf/Exception.fileUnusable" => 10302,
"Conf/Exception.fileUnreadable" => 10303,
"Conf/Exception.fileUnwritable" => 10304,
"Conf/Exception.fileUncreatable" => 10305,
"Conf/Exception.fileCorrupt" => 10306,
Validate configuration parameters on import, and other changes - Each parameter is checked for type and normalized - Interval strings are converted to DateInterval objects - Timeouts can be specified as interval strings - Most intervals can be null to signify infinity - Driver classes are checked that they implement the correct interface - Short driver names may be used, and are used by default - Helpful errors messages are printed in case of erroneous configuration Exporting is currently broken; this will be fixed in an upcoming commit
2019-01-21 03:40:49 +00:00
"Conf/Exception.typeMismatch" => 10311,
"Conf/Exception.semanticMismatch" => 10312,
Unify SQL timeouts - Exec and lock timeouts now apply to MySQL - Lock timeout now applies to PostgreSQL - SQLite now uses a generic lock timeout setting which applies to all
2019-01-23 21:31:54 +00:00
"Conf/Exception.ambiguousDefault" => 10313,
Fix numerous bugs when adding or changing folders - Specifying a non-integer parent no longer silently casts to 0 or 1 - Specifying a folder ID of 0 now always converts to null automatically - Performing both a rename and move to root in the same operation no longer results in potential duplicates - Calling folderSetProperties with an empty data array no peforms an update; it now returns false before the update call - Modification timestamps are now actually updated when a folder is modified - Constraint violation exceptions triggered by code (rather than the database) now print a message - Renaming a folder or subscription to a non-string value (e.g. an array) throws an exception rather than silently casting - Added tests to better cover all the above - Centralized the normalization of integers and title strings into a new ValueInfo static class
2017-09-26 20:45:41 +00:00
"User/Exception.authMissing" => 10411,
"User/Exception.authFailed" => 10412,
Differentiate between duplicate/missing users and other failure modes
2020-11-15 21:24:26 +00:00
"User/ExceptionConflict.doesNotExist" => 10402,
"User/ExceptionConflict.alreadyExists" => 10403,
Merge fixes from master
2017-09-27 00:25:11 +00:00
"User/ExceptionSession.invalid" => 10431,
Prototype changes to user management The driver itself has not been expnaded; more is probably required to ensure metadata is kept in sync and users created when the internal database does not list a user an external database claims to have
2020-11-09 18:43:07 +00:00
"User/ExceptionInput.invalidTimezone" => 10441,
Fix user manager and tests
2020-12-07 05:07:10 +00:00
"User/ExceptionInput.invalidValue" => 10442,
"User/ExceptionInput.invalidNonZeroInteger" => 10443,
"User/ExceptionInput.invalidUsername" => 10444,
Refine and cover new Guzzle error handling
2020-02-03 21:54:45 +00:00
"Feed/Exception.internalError" => 10500,
Fix numerous bugs when adding or changing folders - Specifying a non-integer parent no longer silently casts to 0 or 1 - Specifying a folder ID of 0 now always converts to null automatically - Performing both a rename and move to root in the same operation no longer results in potential duplicates - Calling folderSetProperties with an empty data array no peforms an update; it now returns false before the update call - Modification timestamps are now actually updated when a folder is modified - Constraint violation exceptions triggered by code (rather than the database) now print a message - Renaming a folder or subscription to a non-string value (e.g. an array) throws an exception rather than silently casting - Added tests to better cover all the above - Centralized the normalization of integers and title strings into a new ValueInfo static class
2017-09-26 20:45:41 +00:00
"Feed/Exception.invalidCertificate" => 10501,
"Feed/Exception.invalidUrl" => 10502,
Fix problems with nicolus/picofeed This involved multiple fixes to Picofeed itself, not all of which have been merged upstream yet
2020-01-23 22:07:20 +00:00
"Feed/Exception.maxRedirect" => 10503,
Fix numerous bugs when adding or changing folders - Specifying a non-integer parent no longer silently casts to 0 or 1 - Specifying a folder ID of 0 now always converts to null automatically - Performing both a rename and move to root in the same operation no longer results in potential duplicates - Calling folderSetProperties with an empty data array no peforms an update; it now returns false before the update call - Modification timestamps are now actually updated when a folder is modified - Constraint violation exceptions triggered by code (rather than the database) now print a message - Renaming a folder or subscription to a non-string value (e.g. an array) throws an exception rather than silently casting - Added tests to better cover all the above - Centralized the normalization of integers and title strings into a new ValueInfo static class
2017-09-26 20:45:41 +00:00
"Feed/Exception.maxSize" => 10504,
"Feed/Exception.timeout" => 10505,
"Feed/Exception.forbidden" => 10506,
"Feed/Exception.unauthorized" => 10507,
Start on integrating well-maintained picofeed fork Picofeed configuration does not seem to get passed to Guzzle.
2020-01-21 13:42:38 +00:00
"Feed/Exception.transmissionError" => 10508,
Refine and cover new Guzzle error handling
2020-02-03 21:54:45 +00:00
"Feed/Exception.connectionFailed" => 10509,
Fix numerous bugs when adding or changing folders - Specifying a non-integer parent no longer silently casts to 0 or 1 - Specifying a folder ID of 0 now always converts to null automatically - Performing both a rename and move to root in the same operation no longer results in potential duplicates - Calling folderSetProperties with an empty data array no peforms an update; it now returns false before the update call - Modification timestamps are now actually updated when a folder is modified - Constraint violation exceptions triggered by code (rather than the database) now print a message - Renaming a folder or subscription to a non-string value (e.g. an array) throws an exception rather than silently casting - Added tests to better cover all the above - Centralized the normalization of integers and title strings into a new ValueInfo static class
2017-09-26 20:45:41 +00:00
"Feed/Exception.malformedXml" => 10511,
"Feed/Exception.xmlEntity" => 10512,
"Feed/Exception.subscriptionNotFound" => 10521,
"Feed/Exception.unsupportedFeedFormat" => 10522,
CLI for OPML import, and proper exceptions
2019-05-01 14:46:44 +00:00
"ImportExport/Exception.fileMissing" => 10601,
"ImportExport/Exception.fileUnreadable" => 10603,
Add export-to-file wrapper for OPML
2019-04-01 20:54:14 +00:00
"ImportExport/Exception.fileUnwritable" => 10604,
"ImportExport/Exception.fileUncreatable" => 10605,
CLI for OPML import, and proper exceptions
2019-05-01 14:46:44 +00:00
"ImportExport/Exception.invalidSyntax" => 10611,
"ImportExport/Exception.invalidSemantics" => 10612,
"ImportExport/Exception.invalidFolderName" => 10613,
"ImportExport/Exception.invalidFolderCopy" => 10614,
Do not necessarily ignore blank tags in import We still make them practically impossible in OPML imports, however
2019-07-24 18:20:17 +00:00
"ImportExport/Exception.invalidTagName" => 10615,
Partial implementation of filter rule handling
2021-01-03 21:41:15 +00:00
"Rule/Exception.invalidPattern" => 10701,
Move forking and related to Service class
2021-06-10 22:34:13 +00:00
"Service/Exception.pidNotFile" => 10801,
Finish testing PID file path checking
2021-06-16 16:48:09 +00:00
"Service/Exception.pidDirMissing" => 10802,
"Service/Exception.pidDirUnresolvable" => 10803,
"Service/Exception.pidUnusable" => 10804,
"Service/Exception.pidUnreadable" => 10805,
"Service/Exception.pidUnwritable" => 10806,
"Service/Exception.pidUncreatable" => 10807,
Refine some exceptions
2021-06-21 23:51:27 +00:00
"Service/Exception.pidCorrupt" => 10808,
"Service/Exception.pidDuplicate" => 10809,
"Service/Exception.pidLocked" => 10810,
"Service/Exception.pidInaccessible" => 10811,
More forking tweaks
2021-06-25 23:43:26 +00:00
"Service/Exception.forkFailed" => 10812,
Converted all hard tabs to soft tabs
2017-02-16 20:29:42 +00:00
];
Moved base exception code to abstract class This allows differentiating specific and general exceptions in tests; a library-wide trap would have to trap AbstractException
2017-02-11 19:56:02 +00:00
Prototype OPML handling
2021-02-06 01:29:41 +00:00
protected $symbol;
protected $params;
Address our own deprecations in PHP 8.4
2024-12-15 21:31:57 +00:00
public function __construct(string $msgID = "", $vars = null, ?\Throwable $e = null) {
Prototype OPML handling
2021-02-06 01:29:41 +00:00
$this->symbol = $msgID;
$this->params = $vars ?? [];
Use strict equality when comparing strings
2019-01-11 15:38:06 +00:00
if ($msgID === "") {
Converted all hard tabs to soft tabs
2017-02-16 20:29:42 +00:00
$msg = "Exception.unknown";
$code = 10000;
} else {
$class = get_called_class();
$codeID = str_replace("\\", "/", str_replace(NS_BASE, "", $class)).".$msgID";
Passed code through linter
2017-08-29 14:50:31 +00:00
if (!array_key_exists($codeID, self::CODES)) {
More User tests and resultant fixes
2017-02-21 00:04:08 +00:00
throw new Exception("uncoded", $codeID);
Converted all hard tabs to soft tabs
2017-02-16 20:29:42 +00:00
} else {
$code = self::CODES[$codeID];
$msg = "Exception.".str_replace("\\", "/", $class).".$msgID";
}
Ensure the Lang class always exists when throwing exceptions
2018-10-31 18:32:11 +00:00
$msg = (Arsse::$lang ?? new Lang)->msg($msg, $vars);
Converted all hard tabs to soft tabs
2017-02-16 20:29:42 +00:00
}
parent::__construct($msg, $code, $e);
}
Prototype OPML handling
2021-02-06 01:29:41 +00:00
public function getSymbol(): string {
return $this->symbol;
}
public function getParams(): array {
Tests for new exception features
2021-02-07 14:07:53 +00:00
return $this->params;
Prototype OPML handling
2021-02-06 01:29:41 +00:00
}
Passed code through linter
2017-08-29 14:50:31 +00:00
}
Copy permalink