---
title: "Introducción"
description: "Bridge Python para la Biblioteca PHP"
type: "docs"
category: "doc"
tags: []
authors: [Anonymous]
date: "2026-10-08"
last_update: "2026-10-08"
time_minutes: 3
draft: false
unlisted: false
url: "https://core.libredte.cl/docs/bridge-python/introduccion"
---

# Bridge Python para la Biblioteca PHP

[![CI](https://github.com/libredte/libredte-lib-core-bridge-python/actions/workflows/ci.yml/badge.svg?branch=main&event=push)](https://github.com/libredte/libredte-lib-core-bridge-python/actions/workflows/ci.yml?query=branch%3Amain)
[![PyPI](https://img.shields.io/pypi/v/libredte-lib-core-bridge.svg)](https://pypi.org/project/libredte-lib-core-bridge/)
[![Descargas](https://img.shields.io/pypi/dm/libredte-lib-core-bridge.svg)](https://pypi.org/project/libredte-lib-core-bridge/)

Bridge que expone, desde Python, las operaciones de
`libredte/libredte-lib-core`, a través del
[Dispatcher](https://www.derafu.dev/docs/dispatcher), usando
[`derafu-backbone-bridge`](https://www.derafu.dev/docs/core/backbone-bridge-python)
como base. Repositorio:
[`libredte-lib-core-bridge-python`](https://github.com/libredte/libredte-lib-core-bridge-python).

> [!IMPORTANT] Importante
>
> Aunque se llame "bridge", `phpy` no le habla a un proceso PHP
> aparte: embebe el motor de PHP dentro de tu propio proceso Python
> (es PHP compilado con `--enable-embed`, cargado como librería, no
> un servidor al otro lado de una red). Tu aplicación Python queda
> igual de sujeta a los términos de la
> [licencia AGPL](https://www.derafu.dev/docs/lib/licencia) que si usaras la
> [Biblioteca PHP](https://www.derafu.dev/docs/lib) o el [Dispatcher](https://www.derafu.dev/docs/dispatcher)
> directamente. Si buscas integrarte sin ese efecto, revisa los
> [Servicios Web (API)](https://www.derafu.dev/docs/api), la
> [Imagen Docker (API)](https://www.derafu.dev/docs/docker-api) o la
> [Imagen Docker (Consola)](https://www.derafu.dev/docs/docker-console).

## Requerimientos

Antes de instalar, confirma que tienes:

- Python 3.14 o superior, compilado con soporte para `phpy`. La
  imagen de referencia con esto ya listo es
  [`ghcr.io/derafu/docker-python3.14-caddy-server:phpy`](https://github.com/derafu/docker-python3.14-caddy-server).
- Una instalación real (vía Composer) del
  [Dispatcher](https://www.derafu.dev/docs/dispatcher) accesible en disco.

## Instalación

Se instala con pip:

```shell
pip install libredte-lib-core-bridge
```

## Ejemplo

Un uso mínimo:

```python
from libredte_lib_core_bridge import Dispatcher

# environment='prod', debug=False por defecto.
dispatcher = Dispatcher()

result = dispatcher.dispatch(
    'billing.identifier.caf_loader::load',
    xml=xml_base64,
)
```

`dispatch()` nunca deja pasar un error de PHP sin tipar: lanza una
excepción Python (`derafu_backbone_bridge.BackboneBridgeError` o una
de sus subclases) en vez de una excepción PHP cruda.

> [!NOTE] Nota
>
> Revisa [Uso del Bridge Python](https://www.derafu.dev/docs/bridge-python/uso) para cómo
> apuntarlo a tu instalación del Dispatcher y el manejo de errores.

## Términos y condiciones de uso

Este proyecto es software libre y puede ser redistribuido y/o
modificado bajo los términos de la Licencia Pública General Affero
de GNU (AGPL), versión 3 o (a elección) cualquier versión posterior.
Ver [COPYING](https://github.com/libredte/libredte-lib-core-bridge-python/blob/main/COPYING).



---
Última actualización el 08/10/2026