frankenphp/smartpointer.go

package frankenphp

// #include <stdlib.h>
import "C"
import (
	"runtime/cgo"
	"unsafe"
)

/*
FrankenPHP is fairly complex because it shuffles handles/requests/contexts
between C and Go. This simplifies the lifecycle management of per-request
structures by allowing us to hold references until the end of the request
and ensure they are always cleaned up.
*/

// PointerList A list of pointers that can be freed at a later time
type pointerList struct {
	Pointers []unsafe.Pointer
}

// HandleList A list of pointers that can be freed at a later time
type handleList struct {
	Handles []cgo.Handle
}

// AddHandle Call when registering a handle for the very first time
func (h *handleList) AddHandle(handle cgo.Handle) {
	h.Handles = append(h.Handles, handle)
}

// AddPointer Call when creating a request-level C pointer for the very first time
func (p *pointerList) AddPointer(ptr unsafe.Pointer) {
	p.Pointers = append(p.Pointers, ptr)
}

// FreeAll frees all C pointers
func (p *pointerList) FreeAll() {
	for _, ptr := range p.Pointers {
		C.free(ptr)
	}
	p.Pointers = nil // To avoid dangling pointers
}

// FreeAll frees all handles
func (h *handleList) FreeAll() {
	for _, p := range h.Handles {
		p.Delete()
	}
}

// Pointers Get a new list of pointers
func Pointers() *pointerList {
	return &pointerList{
		Pointers: make([]unsafe.Pointer, 0),
	}
}

// Handles Get a new list of handles
func Handles() *handleList {
	return &handleList{
		Handles: make([]cgo.Handle, 0, 8),
	}
}