From 64d0187b52e5c6b5c96295a9742539d99129700d Mon Sep 17 00:00:00 2001
From: Shish <shish@shishnet.org>
Date: Mon, 27 Jan 2025 12:57:59 +0000
Subject: [PATCH] Remove APC bits

These have been deprecated for a looooooong time, and are no longer even present in 8.1+, which breaks generation with multiple versions
---
 composer.json                              |   1 -
 deprecated/Exceptions/ApcException.php     |  11 -
 deprecated/apc.php                         | 238 ---------------------
 deprecated/functionsList.php               |  10 -
 generated/functionsList.php                |   1 -
 generator/config/specialCasesFunctions.php |   1 -
 generator/tests/DeprecateCommandTest.php   |   6 +-
 lib/special_cases.php                      |  22 --
 rector-migrate.php                         |   1 -
 9 files changed, 2 insertions(+), 289 deletions(-)
 delete mode 100644 deprecated/Exceptions/ApcException.php
 delete mode 100644 deprecated/apc.php

diff --git a/composer.json b/composer.json
index 18a794bf..27ac5329 100644
--- a/composer.json
+++ b/composer.json
@@ -11,7 +11,6 @@
             "generated/Exceptions/"
         ],
         "files": [
-            "deprecated/apc.php",
             "deprecated/array.php",
             "deprecated/datetime.php",
             "deprecated/libevent.php",
diff --git a/deprecated/Exceptions/ApcException.php b/deprecated/Exceptions/ApcException.php
deleted file mode 100644
index 3a9d3c56..00000000
--- a/deprecated/Exceptions/ApcException.php
+++ /dev/null
@@ -1,11 +0,0 @@
-<?php
-namespace Safe\Exceptions;
-
-class ApcException extends \ErrorException implements SafeExceptionInterface
-{
-    public static function createFromPhpError(): self
-    {
-        $error = error_get_last();
-        return new self($error['message'] ?? 'An error occurred', 0, $error['type'] ?? 1);
-    }
-}
diff --git a/deprecated/apc.php b/deprecated/apc.php
deleted file mode 100644
index 7930432c..00000000
--- a/deprecated/apc.php
+++ /dev/null
@@ -1,238 +0,0 @@
-<?php
-
-namespace Safe;
-
-use Safe\Exceptions\ApcException;
-
-/**
- * Retrieves cached information and meta-data from APC's data store.
- *
- * @param string $cache_type If cache_type is "user",
- * information about the user cache will be returned.
- *
- * If cache_type is "filehits",
- * information about which files have been served from the bytecode cache
- * for the current request will be returned. This feature must be enabled at
- * compile time using --enable-filehits.
- *
- * If an invalid or no cache_type is specified, information about
- * the system cache (cached files) will be returned.
- * @param bool $limited If limited is TRUE, the
- * return value will exclude the individual list of cache entries.  This
- * is useful when trying to optimize calls for statistics gathering.
- * @return array Array of cached data (and meta-data)
- * @throws ApcException
- *
- */
-function apc_cache_info(string $cache_type = '', bool $limited = false): array
-{
-    error_clear_last();
-    $result = \apc_cache_info($cache_type, $limited);
-    if ($result === false) {
-        throw ApcException::createFromPhpError();
-    }
-    return $result;
-}
-
-
-/**
- * apc_cas updates an already existing integer value if the
- * old parameter matches the currently stored value
- * with the value of the new parameter.
- *
- * @param string $key The key of the value being updated.
- * @param int $old The old value (the value currently stored).
- * @param int $new The new value to update to.
- * @throws ApcException
- *
- */
-function apc_cas(string $key, int $old, int $new): void
-{
-    error_clear_last();
-    $result = \apc_cas($key, $old, $new);
-    if ($result === false) {
-        throw ApcException::createFromPhpError();
-    }
-}
-
-
-/**
- * Stores a file in the bytecode cache, bypassing all filters.
- *
- * @param string $filename Full or relative path to a PHP file that will be compiled and stored in
- * the bytecode cache.
- * @param bool $atomic
- * @return mixed Returns TRUE on success.
- * @throws ApcException
- *
- */
-function apc_compile_file(string $filename, bool $atomic = true)
-{
-    error_clear_last();
-    $result = \apc_compile_file($filename, $atomic);
-    if ($result === false) {
-        throw ApcException::createFromPhpError();
-    }
-    return $result;
-}
-
-
-/**
- * Decreases a stored integer value.
- *
- * @param string $key The key of the value being decreased.
- * @param int $step The step, or value to decrease.
- * @param bool|null $success Optionally pass the success or fail boolean value to
- * this referenced variable.
- * @return int Returns the current value of key's value on success
- * @throws ApcException
- *
- */
-function apc_dec(string $key, int $step = 1, ?bool &$success = null): int
-{
-    error_clear_last();
-    $result = \apc_dec($key, $step, $success);
-    if ($result === false) {
-        throw ApcException::createFromPhpError();
-    }
-    return $result;
-}
-
-
-/**
- * define is notoriously slow. Since the main benefit of
- * APC is to increase the performance of scripts/applications, this mechanism
- * is provided to streamline the process of mass constant definition. However,
- * this function does not perform as well as anticipated.
- *
- * For a better-performing solution, try the
- * hidef extension from PECL.
- *
- * @param string $key The key serves as the name of the constant set
- * being stored. This key is used to retrieve the
- * stored constants in apc_load_constants.
- * @param array $constants An associative array of constant_name =&gt; value
- * pairs. The constant_name must follow the normal
- * constant naming rules.
- * value must evaluate to a scalar value.
- * @param bool $case_sensitive The default behaviour for constants is to be declared case-sensitive;
- * i.e. CONSTANT and Constant
- * represent different values. If this parameter evaluates to FALSE the
- * constants will be declared as case-insensitive symbols.
- * @throws ApcException
- *
- */
-function apc_define_constants(string $key, array $constants, bool $case_sensitive = true): void
-{
-    error_clear_last();
-    $result = \apc_define_constants($key, $constants, $case_sensitive);
-    if ($result === false) {
-        throw ApcException::createFromPhpError();
-    }
-}
-
-
-/**
- * Deletes the given files from the opcode cache.
- *
- * @param mixed $keys The files to be deleted. Accepts a string,
- * array of strings, or an APCIterator
- * object.
- * @return mixed Returns TRUE on success.
- * Or if keys is an array, then
- * an empty array is returned on success, or an array of failed files
- * is returned.
- * @throws ApcException
- *
- */
-function apc_delete_file($keys)
-{
-    error_clear_last();
-    $result = \apc_delete_file($keys);
-    if ($result === false) {
-        throw ApcException::createFromPhpError();
-    }
-    return $result;
-}
-
-
-/**
- * Removes a stored variable from the cache.
- *
- * @param string|string[]|\APCIterator $key The key used to store the value (with
- * apc_store).
- * @throws ApcException
- *
- */
-function apc_delete($key): void
-{
-    error_clear_last();
-    $result = \apc_delete($key);
-    if ($result === false) {
-        throw ApcException::createFromPhpError();
-    }
-}
-
-
-/**
- * Increases a stored number.
- *
- * @param string $key The key of the value being increased.
- * @param int $step The step, or value to increase.
- * @param bool|null $success Optionally pass the success or fail boolean value to
- * this referenced variable.
- * @return int Returns the current value of key's value on success
- * @throws ApcException
- *
- */
-function apc_inc(string $key, int $step = 1, ?bool &$success = null): int
-{
-    error_clear_last();
-    $result = \apc_inc($key, $step, $success);
-    if ($result === false) {
-        throw ApcException::createFromPhpError();
-    }
-    return $result;
-}
-
-
-/**
- * Loads a set of constants from the cache.
- *
- * @param string $key The name of the constant set (that was stored with
- * apc_define_constants) to be retrieved.
- * @param bool $case_sensitive The default behaviour for constants is to be declared case-sensitive;
- * i.e. CONSTANT and Constant
- * represent different values. If this parameter evaluates to FALSE the
- * constants will be declared as case-insensitive symbols.
- * @throws ApcException
- *
- */
-function apc_load_constants(string $key, bool $case_sensitive = true): void
-{
-    error_clear_last();
-    $result = \apc_load_constants($key, $case_sensitive);
-    if ($result === false) {
-        throw ApcException::createFromPhpError();
-    }
-}
-
-
-/**
- * Retrieves APC's Shared Memory Allocation information.
- *
- * @param bool $limited When set to FALSE (default) apc_sma_info will
- * return a detailed information about each segment.
- * @return array Array of Shared Memory Allocation data; FALSE on failure.
- * @throws ApcException
- *
- */
-function apc_sma_info(bool $limited = false): array
-{
-    error_clear_last();
-    $result = \apc_sma_info($limited);
-    if ($result === false) {
-        throw ApcException::createFromPhpError();
-    }
-    return $result;
-}
diff --git a/deprecated/functionsList.php b/deprecated/functionsList.php
index 67cd77f8..34b858f7 100644
--- a/deprecated/functionsList.php
+++ b/deprecated/functionsList.php
@@ -1,16 +1,6 @@
 <?php
 
 return [
-    'apc_cache_info',
-    'apc_cas',
-    'apc_compile_file',
-    'apc_dec',
-    'apc_define_constants',
-    'apc_delete',
-    'apc_delete_file',
-    'apc_inc',
-    'apc_load_constants',
-    'apc_sma_info',
     'arsort',
     'array_replace',
     'array_replace_recursive',
diff --git a/generated/functionsList.php b/generated/functionsList.php
index 50c6422a..62735a6f 100644
--- a/generated/functionsList.php
+++ b/generated/functionsList.php
@@ -11,7 +11,6 @@
     'apcu_fetch',
     'apcu_inc',
     'apcu_sma_info',
-    'apc_fetch',
     'array_all',
     'base64_decode',
     'bindtextdomain',
diff --git a/generator/config/specialCasesFunctions.php b/generator/config/specialCasesFunctions.php
index 31febcc4..017d6a4f 100644
--- a/generator/config/specialCasesFunctions.php
+++ b/generator/config/specialCasesFunctions.php
@@ -5,7 +5,6 @@
  */
 return [
     'json_decode',
-    'apc_fetch',
     'apcu_fetch',
     'fputcsv',
     'preg_replace',
diff --git a/generator/tests/DeprecateCommandTest.php b/generator/tests/DeprecateCommandTest.php
index 6d631a77..84832ce9 100644
--- a/generator/tests/DeprecateCommandTest.php
+++ b/generator/tests/DeprecateCommandTest.php
@@ -4,14 +4,12 @@
 
 namespace Safe;
 
-
 use PHPUnit\Framework\TestCase;
 
 class DeprecateCommandTest extends TestCase
 {
     public function testExceptionName(): void
     {
-        $this->assertEquals('Exceptions/ApcException.php', DeprecateCommand::getExceptionFilePath('apc'));
+        $this->assertEquals('Exceptions/PasswordException.php', DeprecateCommand::getExceptionFilePath('password'));
     }
-
-}
\ No newline at end of file
+}
diff --git a/lib/special_cases.php b/lib/special_cases.php
index 2b368fce..f3371119 100644
--- a/lib/special_cases.php
+++ b/lib/special_cases.php
@@ -11,7 +11,6 @@
 use Safe\Exceptions\MiscException;
 use Safe\Exceptions\PosixException;
 use Safe\Exceptions\SocketsException;
-use Safe\Exceptions\ApcException;
 use Safe\Exceptions\ApcuException;
 use Safe\Exceptions\JsonException;
 use Safe\Exceptions\OpensslException;
@@ -43,27 +42,6 @@ function json_decode(string $json, bool $associative = false, int $depth = 512,
     return $data;
 }
 
-
-/**
- * Fetchs a stored variable from the cache.
- *
- * @param mixed $key The key used to store the value (with
- * apc_store). If an array is passed then each
- * element is fetched and returned.
- * @return mixed The stored variable or array of variables on success; FALSE on failure
- * @throws ApcException
- *
- */
-function apc_fetch($key)
-{
-    error_clear_last();
-    $result = \apc_fetch($key, $success);
-    if ($success === false) {
-        throw ApcException::createFromPhpError();
-    }
-    return $result;
-}
-
 /**
  * Fetchs an entry from the cache.
  *
diff --git a/rector-migrate.php b/rector-migrate.php
index 40af01b2..d84fbaed 100644
--- a/rector-migrate.php
+++ b/rector-migrate.php
@@ -18,7 +18,6 @@
             'apcu_fetch' => 'Safe\apcu_fetch',
             'apcu_inc' => 'Safe\apcu_inc',
             'apcu_sma_info' => 'Safe\apcu_sma_info',
-            'apc_fetch' => 'Safe\apc_fetch',
             'array_all' => 'Safe\array_all',
             'base64_decode' => 'Safe\base64_decode',
             'bindtextdomain' => 'Safe\bindtextdomain',