xref: /php-src/ext/standard/file.h (revision 064ea9c5)
1 /*
2    +----------------------------------------------------------------------+
3    | Copyright (c) The PHP Group                                          |
4    +----------------------------------------------------------------------+
5    | This source file is subject to version 3.01 of the PHP license,      |
6    | that is bundled with this package in the file LICENSE, and is        |
7    | available through the world-wide-web at the following url:           |
8    | https://www.php.net/license/3_01.txt                                 |
9    | If you did not receive a copy of the PHP license and are unable to   |
10    | obtain it through the world-wide-web, please send a note to          |
11    | license@php.net so we can mail you a copy immediately.               |
12    +----------------------------------------------------------------------+
13    | Author: Rasmus Lerdorf <rasmus@lerdorf.on.ca>                        |
14    +----------------------------------------------------------------------+
15 */
16 
17 #ifndef FILE_H
18 #define FILE_H
19 
20 #include "php_network.h"
21 
22 PHP_MINIT_FUNCTION(file);
23 PHP_MSHUTDOWN_FUNCTION(file);
24 
25 PHPAPI PHP_FUNCTION(fclose);
26 PHPAPI PHP_FUNCTION(feof);
27 PHPAPI PHP_FUNCTION(fread);
28 PHPAPI PHP_FUNCTION(fgetc);
29 PHPAPI PHP_FUNCTION(fgets);
30 PHPAPI PHP_FUNCTION(fwrite);
31 PHPAPI PHP_FUNCTION(fflush);
32 PHPAPI PHP_FUNCTION(rewind);
33 PHPAPI PHP_FUNCTION(ftell);
34 PHPAPI PHP_FUNCTION(fseek);
35 PHPAPI PHP_FUNCTION(fpassthru);
36 
37 PHP_MINIT_FUNCTION(user_streams);
38 
39 PHPAPI int php_le_stream_context(void);
40 PHPAPI zend_result php_copy_file(const char *src, const char *dest);
41 PHPAPI zend_result php_copy_file_ex(const char *src, const char *dest, int src_flags);
42 PHPAPI zend_result php_copy_file_ctx(const char *src, const char *dest, int src_flags, php_stream_context *ctx);
43 PHPAPI void php_fstat(php_stream *stream, zval *return_value);
44 PHPAPI void php_flock_common(php_stream *stream, zend_long operation, uint32_t operation_arg_num,
45 	zval *wouldblock, zval *return_value);
46 
47 #define PHP_CSV_NO_ESCAPE EOF
48 #define PHP_CSV_ESCAPE_ERROR -500
49 
50 PHPAPI HashTable *php_bc_fgetcsv_empty_line(void);
51 PHPAPI int php_csv_handle_escape_argument(const zend_string *escape_str, uint32_t arg_num);
52 PHPAPI HashTable *php_fgetcsv(php_stream *stream, char delimiter, char enclosure, int escape_char, size_t buf_len, char *buf);
53 PHPAPI ssize_t php_fputcsv(php_stream *stream, zval *fields, char delimiter, char enclosure, int escape_char, zend_string *eol_str);
54 
55 #define META_DEF_BUFSIZE 8192
56 
57 #define PHP_FILE_USE_INCLUDE_PATH (1 << 0)
58 #define PHP_FILE_IGNORE_NEW_LINES (1 << 1)
59 #define PHP_FILE_SKIP_EMPTY_LINES (1 << 2)
60 #define PHP_FILE_APPEND (1 << 3)
61 #define PHP_FILE_NO_DEFAULT_CONTEXT (1 << 4)
62 
63 #ifndef _WIN32
64 #define PHP_TIMEOUT_ULL_MAX ULLONG_MAX
65 #else
66 #define PHP_TIMEOUT_ULL_MAX UINT64_MAX
67 #endif
68 
69 typedef enum _php_meta_tags_token {
70 	TOK_EOF = 0,
71 	TOK_OPENTAG,
72 	TOK_CLOSETAG,
73 	TOK_SLASH,
74 	TOK_EQUAL,
75 	TOK_SPACE,
76 	TOK_ID,
77 	TOK_STRING,
78 	TOK_OTHER
79 } php_meta_tags_token;
80 
81 typedef struct _php_meta_tags_data {
82 	php_stream *stream;
83 	int ulc;
84 	int lc;
85 	char *input_buffer;
86 	char *token_data;
87 	int token_len;
88 	int in_meta;
89 } php_meta_tags_data;
90 
91 php_meta_tags_token php_next_meta_token(php_meta_tags_data *);
92 
93 typedef struct {
94 	int pclose_ret;
95 	size_t def_chunk_size;
96 	bool auto_detect_line_endings;
97 	zend_long default_socket_timeout;
98 	char *user_agent; /* for the http wrapper */
99 	char *from_address; /* for the ftp and http wrappers */
100 	const char *user_stream_current_filename; /* for simple recursion protection */
101 	php_stream_context *default_context;
102 	HashTable *stream_wrappers;			/* per-request copy of url_stream_wrappers_hash */
103 	HashTable *stream_filters;			/* per-request copy of stream_filters_hash */
104 	HashTable *wrapper_errors;			/* key: wrapper address; value: linked list of char* */
105 	int pclose_wait;
106 #ifdef HAVE_GETHOSTBYNAME_R
107 	struct hostent tmp_host_info;
108 	char *tmp_host_buf;
109 	size_t tmp_host_buf_len;
110 #endif
111 } php_file_globals;
112 
113 #ifdef ZTS
114 #define FG(v) ZEND_TSRMG(file_globals_id, php_file_globals *, v)
115 extern PHPAPI int file_globals_id;
116 #else
117 #define FG(v) (file_globals.v)
118 extern PHPAPI php_file_globals file_globals;
119 #endif
120 
121 
122 #endif /* FILE_H */
123