mirror of
https://github.com/php/php-src.git
synced 2026-04-01 21:22:13 +02:00
Since long the default PHP charset is UTF-8, however the Windows part is out of step with this important point. The current implementation in PHP doesn't technically permit to handle UTF-8 filepath and several other things. Till now, only the ANSI compatible APIs are being used. Here is more about it https://msdn.microsoft.com/en-us/library/windows/desktop/dd317752%28v=vs.85%29.aspx The patch fixes not only issues with multibyte filenames under incompatible codepages, but indirectly also issues with some other multibyte encodings like BIG5, Shift-JIS, etc. by providing a clean way to access filenames in UTF-8. Below is a small list of issues from the bug tracker, that are getting fixed: https://bugs.php.net/63401 https://bugs.php.net/41199 https://bugs.php.net/50203 https://bugs.php.net/71509 https://bugs.php.net/64699 https://bugs.php.net/64506 https://bugs.php.net/30195 https://bugs.php.net/65358 https://bugs.php.net/61315 https://bugs.php.net/70943 https://bugs.php.net/70903 https://bugs.php.net/63593 https://bugs.php.net/54977 https://bugs.php.net/54028 https://bugs.php.net/43148 https://bugs.php.net/30730 https://bugs.php.net/33350 https://bugs.php.net/35300 https://bugs.php.net/46990 https://bugs.php.net/61309 https://bugs.php.net/69333 https://bugs.php.net/45517 https://bugs.php.net/70551 https://bugs.php.net/50197 https://bugs.php.net/72200 https://bugs.php.net/37672 Yet more related tickets can for sure be found - on bugs.php.net, Stackoverflow and Github. Some of the bugs are pretty recent, some descend to early 2000th, but the user comments in there last even till today. Just for example, bug #30195 was opened in 2004, the latest comment in there was made in 2014. It is certain, that these bugs descend not only to pure PHP use cases, but get also redirected from the popular PHP based projects. Given the modern systems (and those supported by PHP) are always based on NTFS, there is no excuse to keep these issues unresolved. The internalization approach on Windows is in many ways different from UNIX and Linux, while it supports and is based on Unicode. It depends on the current system code page, APIs used and exact kind how the binary was compiled The locale doesn't affect the way Unicode or ANSI API work. PHP in particular is being compiled without _UNICODE defined and this is conditioned by the way we handle strings. Here is more about it https://msdn.microsoft.com/en-us/library/tsbaswba.aspx However, with any system code page ANSI functions automatically convert paths to UTF-16. Paths in some encodings incompatible with the current system code page, won't work correctly with ANSI APIs. PHP till now only uses the ANSI Windows APIs. For example, on a system with the current code page 1252, the paths in cp1252 are supported and transparently converted to UTF-16 by the ANSI functions. Once one wants to handle a filepath encoded with cp932 on that particular system, an ANSI or a POSIX compatible function used in PHP will produce an erroneous result. When trying to convert that cp932 path to UTF-8 and passing to the ANSI functions, an ANSI function would likely interpret the UTF-8 string as some string in the current code page and create a filepath that represents every single byte of the UTF-8 string. These behaviors are not only broken but also disregard the documented INI settings. This patch solves the issies with the multibyte paths on Windows by intelligently enforcing the usage of the Unicode aware APIs. For functions expect Unicode (fe CreateFileW, FindFirstFileW, etc.), arguments will be converted to UTF-16 wide chars. For functions returning Unicode aware data (fe GetCurrentDirectoryW, etc.), resulting wide string is converted back to char's depending on the current PHP charset settings, either to the current ANSI codepage (this is the behavior prior to this patch) or to UTF-8 (the default behavior). In a particular case, users might have to explicitly set internal_encoding or default_charset, if filenames in ANSI codepage are necessary. Current tests show no regressions and witness that this will be an exotic case, the current default UTF-8 encoding is compatible with any supported system. The dependency libraries are long switching to Unicode APIs, so some tests were also added for extensions not directly related to streams. At large, the patch brings over 150 related tests into the core. Those target and was run on various environments with European, Asian, etc. codepages. General PHP frameworks was tested and showed no regressions. The impact on the current C code base is low, the most places affected are the Windows only places in the three files tsrm_win32.c, zend_virtual_cwd.c and plain_wrapper.c. The actual implementation of the most of the wide char supporting functionality is in win32/ioutil.* and win32/codepage.*, several low level functionsare extended in place to avoid reimplementation for now. No performance impact was sighted. As previously mentioned, the ANSI APIs used prior the patch perform Unicode conversions internally. Using the Unicode APIs directly while doing custom conversions just retains the status quo. The ways to optimize it are open (fe. by implementing caching for the strings converted to wide variants). The long path implementation is user transparent. If a path exceeds the length of _MAX_PATH, it'll be automatically prefixed with \\?\. The MAXPATHLEN is set to 2048 bytes. Appreciation to Pierre Joye, Matt Ficken, @algo13 and others for tips, ideas and testing. Thanks.
271 lines
7.5 KiB
C
271 lines
7.5 KiB
C
/*
|
|
+----------------------------------------------------------------------+
|
|
| PHP Version 7 |
|
|
+----------------------------------------------------------------------+
|
|
| Copyright (c) 1997-2016 The PHP Group |
|
|
+----------------------------------------------------------------------+
|
|
| This source file is subject to version 3.01 of the PHP license, |
|
|
| that is bundled with this package in the file LICENSE, and is |
|
|
| available through the world-wide-web at the following url: |
|
|
| http://www.php.net/license/3_01.txt |
|
|
| If you did not receive a copy of the PHP license and are unable to |
|
|
| obtain it through the world-wide-web, please send a note to |
|
|
| license@php.net so we can mail you a copy immediately. |
|
|
+----------------------------------------------------------------------+
|
|
| Authors: Andi Gutmans <andi@zend.com> |
|
|
| Zeev Suraski <zeev@zend.com> |
|
|
+----------------------------------------------------------------------+
|
|
*/
|
|
|
|
/* $Id$ */
|
|
|
|
#ifndef BASIC_FUNCTIONS_H
|
|
#define BASIC_FUNCTIONS_H
|
|
|
|
#include <sys/stat.h>
|
|
|
|
#ifdef HAVE_WCHAR_H
|
|
#include <wchar.h>
|
|
#endif
|
|
|
|
#include "php_filestat.h"
|
|
|
|
#include "zend_highlight.h"
|
|
|
|
#include "url_scanner_ex.h"
|
|
|
|
#if defined(_WIN32) && defined(__clang__)
|
|
#include <intrin.h>
|
|
#endif
|
|
|
|
extern zend_module_entry basic_functions_module;
|
|
#define basic_functions_module_ptr &basic_functions_module
|
|
|
|
PHP_MINIT_FUNCTION(basic);
|
|
PHP_MSHUTDOWN_FUNCTION(basic);
|
|
PHP_RINIT_FUNCTION(basic);
|
|
PHP_RSHUTDOWN_FUNCTION(basic);
|
|
PHP_MINFO_FUNCTION(basic);
|
|
|
|
PHP_FUNCTION(constant);
|
|
PHP_FUNCTION(sleep);
|
|
PHP_FUNCTION(usleep);
|
|
#if HAVE_NANOSLEEP
|
|
PHP_FUNCTION(time_nanosleep);
|
|
PHP_FUNCTION(time_sleep_until);
|
|
#endif
|
|
PHP_FUNCTION(flush);
|
|
#ifdef HAVE_INET_NTOP
|
|
PHP_NAMED_FUNCTION(php_inet_ntop);
|
|
#endif
|
|
#ifdef HAVE_INET_PTON
|
|
PHP_NAMED_FUNCTION(php_inet_pton);
|
|
#endif
|
|
PHP_FUNCTION(ip2long);
|
|
PHP_FUNCTION(long2ip);
|
|
|
|
/* system functions */
|
|
PHP_FUNCTION(getenv);
|
|
PHP_FUNCTION(putenv);
|
|
|
|
PHP_FUNCTION(getopt);
|
|
|
|
PHP_FUNCTION(get_current_user);
|
|
PHP_FUNCTION(set_time_limit);
|
|
|
|
PHP_FUNCTION(header_register_callback);
|
|
|
|
PHP_FUNCTION(get_cfg_var);
|
|
PHP_FUNCTION(get_magic_quotes_runtime);
|
|
PHP_FUNCTION(get_magic_quotes_gpc);
|
|
|
|
PHP_FUNCTION(error_log);
|
|
PHP_FUNCTION(error_get_last);
|
|
PHP_FUNCTION(error_clear_last);
|
|
|
|
PHP_FUNCTION(call_user_func);
|
|
PHP_FUNCTION(call_user_func_array);
|
|
PHP_FUNCTION(forward_static_call);
|
|
PHP_FUNCTION(forward_static_call_array);
|
|
|
|
PHP_FUNCTION(register_shutdown_function);
|
|
PHP_FUNCTION(highlight_file);
|
|
PHP_FUNCTION(highlight_string);
|
|
PHP_FUNCTION(php_strip_whitespace);
|
|
ZEND_API void php_get_highlight_struct(zend_syntax_highlighter_ini *syntax_highlighter_ini);
|
|
|
|
PHP_FUNCTION(ini_get);
|
|
PHP_FUNCTION(ini_get_all);
|
|
PHP_FUNCTION(ini_set);
|
|
PHP_FUNCTION(ini_restore);
|
|
PHP_FUNCTION(get_include_path);
|
|
PHP_FUNCTION(set_include_path);
|
|
PHP_FUNCTION(restore_include_path);
|
|
|
|
PHP_FUNCTION(print_r);
|
|
PHP_FUNCTION(fprintf);
|
|
PHP_FUNCTION(vfprintf);
|
|
|
|
PHP_FUNCTION(connection_aborted);
|
|
PHP_FUNCTION(connection_status);
|
|
PHP_FUNCTION(ignore_user_abort);
|
|
|
|
PHP_FUNCTION(getservbyname);
|
|
PHP_FUNCTION(getservbyport);
|
|
PHP_FUNCTION(getprotobyname);
|
|
PHP_FUNCTION(getprotobynumber);
|
|
|
|
PHP_NAMED_FUNCTION(php_if_crc32);
|
|
|
|
PHP_FUNCTION(register_tick_function);
|
|
PHP_FUNCTION(unregister_tick_function);
|
|
#ifdef HAVE_GETLOADAVG
|
|
PHP_FUNCTION(sys_getloadavg);
|
|
#endif
|
|
|
|
PHP_FUNCTION(is_uploaded_file);
|
|
PHP_FUNCTION(move_uploaded_file);
|
|
|
|
/* From the INI parser */
|
|
PHP_FUNCTION(parse_ini_file);
|
|
PHP_FUNCTION(parse_ini_string);
|
|
#if ZEND_DEBUG
|
|
PHP_FUNCTION(config_get_hash);
|
|
#endif
|
|
|
|
#if defined(PHP_WIN32)
|
|
PHP_FUNCTION(sapi_windows_cp_set);
|
|
PHP_FUNCTION(sapi_windows_cp_get);
|
|
PHP_FUNCTION(sapi_windows_cp_is_utf8);
|
|
PHP_FUNCTION(sapi_windows_cp_conv);
|
|
#endif
|
|
|
|
PHP_FUNCTION(str_rot13);
|
|
PHP_FUNCTION(stream_get_filters);
|
|
PHP_FUNCTION(stream_filter_register);
|
|
PHP_FUNCTION(stream_bucket_make_writeable);
|
|
PHP_FUNCTION(stream_bucket_prepend);
|
|
PHP_FUNCTION(stream_bucket_append);
|
|
PHP_FUNCTION(stream_bucket_new);
|
|
PHP_MINIT_FUNCTION(user_filters);
|
|
PHP_RSHUTDOWN_FUNCTION(user_filters);
|
|
PHP_RSHUTDOWN_FUNCTION(browscap);
|
|
|
|
/* Left for BC (not binary safe!) */
|
|
PHPAPI int _php_error_log(int opt_err, char *message, char *opt, char *headers);
|
|
PHPAPI int _php_error_log_ex(int opt_err, char *message, size_t message_len, char *opt, char *headers);
|
|
PHPAPI int php_prefix_varname(zval *result, zval *prefix, char *var_name, size_t var_name_len, zend_bool add_underscore);
|
|
|
|
#define MT_N (624)
|
|
|
|
/* Deprecated type aliases -- use the standard types instead */
|
|
typedef uint32_t php_uint32;
|
|
typedef int32_t php_int32;
|
|
|
|
typedef struct _php_basic_globals {
|
|
HashTable *user_shutdown_function_names;
|
|
HashTable putenv_ht;
|
|
zval strtok_zval;
|
|
char *strtok_string;
|
|
zend_string *locale_string; /* current LC_CTYPE locale (or NULL for 'C') */
|
|
zend_bool locale_changed; /* locale was changed and has to be restored */
|
|
char *strtok_last;
|
|
char strtok_table[256];
|
|
zend_ulong strtok_len;
|
|
char str_ebuf[40];
|
|
zend_fcall_info array_walk_fci;
|
|
zend_fcall_info_cache array_walk_fci_cache;
|
|
zend_fcall_info user_compare_fci;
|
|
zend_fcall_info_cache user_compare_fci_cache;
|
|
zend_llist *user_tick_functions;
|
|
|
|
zval active_ini_file_section;
|
|
|
|
/* pageinfo.c */
|
|
zend_long page_uid;
|
|
zend_long page_gid;
|
|
zend_long page_inode;
|
|
time_t page_mtime;
|
|
|
|
/* filestat.c && main/streams/streams.c */
|
|
char *CurrentStatFile, *CurrentLStatFile;
|
|
php_stream_statbuf ssb, lssb;
|
|
|
|
/* rand.c */
|
|
uint32_t state[MT_N+1]; /* state vector + 1 extra to not violate ANSI C */
|
|
uint32_t *next; /* next random value is computed from here */
|
|
int left; /* can *next++ this many times before reloading */
|
|
|
|
unsigned int rand_seed; /* Seed for rand(), in ts version */
|
|
|
|
zend_bool rand_is_seeded; /* Whether rand() has been seeded */
|
|
zend_bool mt_rand_is_seeded; /* Whether mt_rand() has been seeded */
|
|
|
|
/* syslog.c */
|
|
char *syslog_device;
|
|
|
|
/* var.c */
|
|
zend_class_entry *incomplete_class;
|
|
unsigned serialize_lock; /* whether to use the locally supplied var_hash instead (__sleep/__wakeup) */
|
|
struct {
|
|
struct php_serialize_data *data;
|
|
unsigned level;
|
|
} serialize;
|
|
struct {
|
|
struct php_unserialize_data *data;
|
|
unsigned level;
|
|
} unserialize;
|
|
|
|
/* url_scanner_ex.re */
|
|
url_adapt_state_ex_t url_adapt_state_ex;
|
|
|
|
#ifdef HAVE_MMAP
|
|
void *mmap_file;
|
|
size_t mmap_len;
|
|
#endif
|
|
|
|
HashTable *user_filter_map;
|
|
|
|
/* file.c */
|
|
#if defined(_REENTRANT) && defined(HAVE_MBRLEN) && defined(HAVE_MBSTATE_T)
|
|
mbstate_t mblen_state;
|
|
#endif
|
|
|
|
int umask;
|
|
} php_basic_globals;
|
|
|
|
#ifdef ZTS
|
|
#define BG(v) ZEND_TSRMG(basic_globals_id, php_basic_globals *, v)
|
|
PHPAPI extern int basic_globals_id;
|
|
#else
|
|
#define BG(v) (basic_globals.v)
|
|
PHPAPI extern php_basic_globals basic_globals;
|
|
#endif
|
|
|
|
#if HAVE_PUTENV
|
|
typedef struct {
|
|
char *putenv_string;
|
|
char *previous_value;
|
|
char *key;
|
|
int key_len;
|
|
} putenv_entry;
|
|
#endif
|
|
|
|
PHPAPI double php_get_nan(void);
|
|
PHPAPI double php_get_inf(void);
|
|
|
|
typedef struct _php_shutdown_function_entry {
|
|
zval *arguments;
|
|
int arg_count;
|
|
} php_shutdown_function_entry;
|
|
|
|
PHPAPI extern zend_bool register_user_shutdown_function(char *function_name, size_t function_len, php_shutdown_function_entry *shutdown_function_entry);
|
|
PHPAPI extern zend_bool remove_user_shutdown_function(char *function_name, size_t function_len);
|
|
PHPAPI extern zend_bool append_user_shutdown_function(php_shutdown_function_entry shutdown_function_entry);
|
|
|
|
PHPAPI void php_call_shutdown_functions(void);
|
|
PHPAPI void php_free_shutdown_functions(void);
|
|
|
|
|
|
#endif /* BASIC_FUNCTIONS_H */
|