Drew Paroski
84b9d9a3a2
In HHVM (and HPHPc before it) we've been piggybacking resources on the KindOfObject machinery. At the language level, resource is considered to be a different type than object, and there are a number of differences in behavior between objects and resources (ex. resources don't allow for dynamic properties, resources don't work with the clone operator, the "(object)" cast behaves differently for resources vs. objects, etc). Piggybacking resources on the KindOfObject machinery has some downsides. Code that deals with KindOfObject values often needs to check if the value is a resource and go down a different code path. This makes things harder to maintain and harder to keep parity with Zend. Also, these extra branches hurt performance a little, and they make it harder for the JIT to do a good job in some cases when its generating machine code that operates on objects. This diff prepares the code base for a new KindOfResource type by adding a new "Resource" smart pointer type (currently a typedef for the Object smart pointer type) and it updates the C++ code and the idl files appropriately. This diff is essentially a cosmetic change and should not impact run time behavior. In the next diff (part 2) we'll actually add a new KindOfResource type, detach ResourceData from the ObjectData inheritence hierarchy, and provide a real implementation for the Resource smart pointer type (instead of just aliasing the Object smart pointer type).
151 linhas
5.9 KiB
C++
151 linhas
5.9 KiB
C++
/*
|
|
+----------------------------------------------------------------------+
|
|
| HipHop for PHP |
|
|
+----------------------------------------------------------------------+
|
|
| Copyright (c) 2010-2013 Facebook, Inc. (http://www.facebook.com) |
|
|
| Copyright (c) 1997-2010 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. |
|
|
+----------------------------------------------------------------------+
|
|
*/
|
|
|
|
#ifndef incl_HPHP_EXT_STREAM_H_
|
|
#define incl_HPHP_EXT_STREAM_H_
|
|
|
|
#include "hphp/runtime/base/base_includes.h"
|
|
#include "hphp/runtime/base/file_repository.h"
|
|
|
|
namespace HPHP {
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
// stream context
|
|
|
|
class StreamContext : public ResourceData {
|
|
public:
|
|
DECLARE_OBJECT_ALLOCATION(StreamContext);
|
|
|
|
static StaticString s_class_name;
|
|
// overriding ResourceData
|
|
virtual CStrRef o_getClassNameHook() const { return s_class_name; }
|
|
|
|
StreamContext(CArrRef options, CArrRef params)
|
|
: m_options(options), m_params(params) {
|
|
}
|
|
Array m_options;
|
|
Array m_params;
|
|
};
|
|
|
|
Resource f_stream_context_create(CArrRef options = null_array,
|
|
CArrRef params = null_array);
|
|
|
|
Object f_stream_context_get_default(CArrRef options = null_array);
|
|
|
|
Variant f_stream_context_get_options(CResRef stream_or_context);
|
|
|
|
bool f_stream_context_set_option(CResRef stream_or_context,
|
|
CVarRef wrapper,
|
|
CStrRef option = null_string,
|
|
CVarRef value = null_variant);
|
|
|
|
bool f_stream_context_set_param(CResRef stream_or_context,
|
|
CArrRef params);
|
|
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
|
|
Variant f_stream_copy_to_stream(CResRef source, CResRef dest,
|
|
int maxlength = -1, int offset = 0);
|
|
|
|
bool f_stream_encoding(CResRef stream, CStrRef encoding = null_string);
|
|
|
|
void f_stream_bucket_append(CResRef brigade, CResRef bucket);
|
|
|
|
void f_stream_bucket_prepend(CResRef brigade, CResRef bucket);
|
|
|
|
Object f_stream_bucket_make_writeable(CResRef brigade);
|
|
|
|
Object f_stream_bucket_new(CResRef stream, CStrRef buffer);
|
|
|
|
bool f_stream_filter_register(CStrRef filtername, CStrRef classname);
|
|
|
|
bool f_stream_filter_remove(CResRef stream_filter);
|
|
|
|
Object f_stream_filter_append(CResRef stream, CStrRef filtername,
|
|
int read_write = 0,
|
|
CVarRef params = null_variant);
|
|
|
|
Object f_stream_filter_prepend(CResRef stream, CStrRef filtername,
|
|
int read_write = 0,
|
|
CVarRef params = null_variant);
|
|
|
|
Variant f_stream_get_contents(CResRef handle, int maxlen = 0,
|
|
int offset = 0);
|
|
|
|
Array f_stream_get_filters();
|
|
|
|
Variant f_stream_get_line(CResRef handle, int length = 0,
|
|
CStrRef ending = null_string);
|
|
|
|
Variant f_stream_get_meta_data(CResRef stream);
|
|
|
|
Array f_stream_get_transports();
|
|
|
|
Array f_stream_get_wrappers();
|
|
bool f_stream_register_wrapper(CStrRef protocol, CStrRef classname);
|
|
bool f_stream_wrapper_register(CStrRef protocol, CStrRef classname);
|
|
bool f_stream_wrapper_restore(CStrRef protocol);
|
|
bool f_stream_wrapper_unregister(CStrRef protocol);
|
|
|
|
String f_stream_resolve_include_path(CStrRef filename,
|
|
CResRef context = null_resource);
|
|
|
|
Variant f_stream_select(VRefParam read, VRefParam write, VRefParam except,
|
|
CVarRef vtv_sec, int tv_usec = 0);
|
|
|
|
bool f_stream_set_blocking(CResRef stream, int mode);
|
|
|
|
bool f_stream_set_timeout(CResRef stream, int seconds, int microseconds = 0);
|
|
|
|
int64_t f_stream_set_write_buffer(CResRef stream, int buffer);
|
|
|
|
int64_t f_set_file_buffer(CResRef stream, int buffer);
|
|
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
// stream sockets: ext_socket has better implementation of socket functions
|
|
|
|
Variant f_stream_socket_accept(CResRef server_socket, double timeout = 0.0,
|
|
VRefParam peername = uninit_null());
|
|
|
|
Variant f_stream_socket_server(CStrRef local_socket, VRefParam errnum = uninit_null(),
|
|
VRefParam errstr = uninit_null(),
|
|
int flags = 0, CResRef context = null_resource);
|
|
|
|
Variant f_stream_socket_client(CStrRef remote_socket, VRefParam errnum = uninit_null(),
|
|
VRefParam errstr = uninit_null(), double timeout = 0.0,
|
|
int flags = 0, CResRef context = null_resource);
|
|
|
|
Variant f_stream_socket_enable_crypto(CResRef stream, bool enable,
|
|
int crypto_type = 0,
|
|
CResRef session_stream = null_resource);
|
|
|
|
Variant f_stream_socket_get_name(CResRef handle, bool want_peer);
|
|
|
|
Variant f_stream_socket_pair(int domain, int type, int protocol);
|
|
|
|
Variant f_stream_socket_recvfrom(CResRef socket, int length, int flags = 0,
|
|
CStrRef address = null_string);
|
|
|
|
Variant f_stream_socket_sendto(CResRef socket, CStrRef data, int flags = 0,
|
|
CStrRef address = null_string);
|
|
|
|
bool f_stream_socket_shutdown(CResRef stream, int how);
|
|
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
}
|
|
|
|
#endif // incl_HPHP_EXT_STREAM_H_
|