xref: /php-src/ext/standard/file.h (revision 4ccf0b01)
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 int php_set_sock_blocking(php_socket_t socketd, int block);
41 PHPAPI int php_copy_file(const char *src, const char *dest);
42 PHPAPI int php_copy_file_ex(const char *src, const char *dest, int src_chk);
43 PHPAPI int php_copy_file_ctx(const char *src, const char *dest, int src_chk, php_stream_context *ctx);
44 PHPAPI int php_mkdir_ex(const char *dir, zend_long mode, int options);
45 PHPAPI int php_mkdir(const char *dir, zend_long mode);
46 PHPAPI void php_fstat(php_stream *stream, zval *return_value);
47 PHPAPI void php_flock_common(php_stream *stream, zend_long operation, uint32_t operation_arg_num,
48 	zval *wouldblock, zval *return_value);
49 
50 #define PHP_CSV_NO_ESCAPE EOF
51 PHPAPI HashTable *php_bc_fgetcsv_empty_line(void);
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 typedef enum _php_meta_tags_token {
64 	TOK_EOF = 0,
65 	TOK_OPENTAG,
66 	TOK_CLOSETAG,
67 	TOK_SLASH,
68 	TOK_EQUAL,
69 	TOK_SPACE,
70 	TOK_ID,
71 	TOK_STRING,
72 	TOK_OTHER
73 } php_meta_tags_token;
74 
75 typedef struct _php_meta_tags_data {
76 	php_stream *stream;
77 	int ulc;
78 	int lc;
79 	char *input_buffer;
80 	char *token_data;
81 	int token_len;
82 	int in_meta;
83 } php_meta_tags_data;
84 
85 php_meta_tags_token php_next_meta_token(php_meta_tags_data *);
86 
87 typedef struct {
88 	int pclose_ret;
89 	size_t def_chunk_size;
90 	bool auto_detect_line_endings;
91 	zend_long default_socket_timeout;
92 	char *user_agent; /* for the http wrapper */
93 	char *from_address; /* for the ftp and http wrappers */
94 	const char *user_stream_current_filename; /* for simple recursion protection */
95 	php_stream_context *default_context;
96 	HashTable *stream_wrappers;			/* per-request copy of url_stream_wrappers_hash */
97 	HashTable *stream_filters;			/* per-request copy of stream_filters_hash */
98 	HashTable *wrapper_errors;			/* key: wrapper address; value: linked list of char* */
99 	int pclose_wait;
100 #ifdef HAVE_GETHOSTBYNAME_R
101 	struct hostent tmp_host_info;
102 	char *tmp_host_buf;
103 	size_t tmp_host_buf_len;
104 #endif
105 } php_file_globals;
106 
107 #ifdef ZTS
108 #define FG(v) ZEND_TSRMG(file_globals_id, php_file_globals *, v)
109 extern PHPAPI int file_globals_id;
110 #else
111 #define FG(v) (file_globals.v)
112 extern PHPAPI php_file_globals file_globals;
113 #endif
114 
115 
116 #endif /* FILE_H */
117