Mis apuntes · Aprende Python desde PHP

Se guardan solos en este navegador mientras escribes. Puedes usar Markdown. Al descargarlos, la primera línea es tu enlace personal al curso.

Lección 9 de 47 · El array de PHP en Python ✦ WebMCP implementado

dict: el array asociativo (con orden)

10 min de lectura 4 retos

El dict es la otra mitad del array de PHP: el array asociativo, clave => valor. En Python es un tipo aparte, con sus propios métodos, y se comporta distinto en un detalle importante: pedir una clave que no existe lanza un error, no un aviso.

¿De dónde vienen los nombres?

dict = abreviatura de inglés dictionary (diccionario)
En un diccionario buscas una palabra (la clave) y encuentras su definición (el valor). Es tu array asociativo de PHP.
get = inglés get (obtener)
Pide un valor y, si la clave no existe, te da otro por defecto en vez de fallar. Es el $a["x"] ?? defecto de PHP.
setdefault = inglés set default (poner por defecto)
«Si no está esta clave, ponla con este valor, y dame lo que haya». Sirve para ir agrupando cosas.
items = inglés items (elementos)
Da los pares (clave, valor) para recorrerlos con for. Es el foreach ($a as $k => $v) de PHP.
KeyError = inglés key error (error de clave)
La excepción que salta al pedir con [] una clave que no existe.
hashable = inglés hash (picadillo: algo troceado y mezclado) + -able (que se puede)
Un valor que Python puede convertir en un número fijo (su hash) para encontrarlo rápido. Solo lo inmutable lo es: por eso un texto o una tupla pueden ser clave y una lista no.
En 4 ideas
1/4

dict es el array asociativo de PHP: {"titulo": "Pan", "prioridad": 2}. Mantiene el orden en que insertas las claves, y las claves pueden ser textos, números o tuplas, pero no listas.

1 · Qué es un diccionario y cuándo usarlo

Una lista es un edificio con pisos numerados: tienes que saber en qué piso vive cada cosa. Un diccionario es una agenda de contactos: buscas por el nombre y te sale el teléfono. Se escribe con llaves, y cada par es clave: valor.

Pythonmain.py
# En PHP: $tarea = ["titulo" => "Comprar pan", "prioridad" => 2, "hecha" => false];
tarea = {"titulo": "Comprar pan", "prioridad": 2, "hecha": False}

# En PHP: echo $tarea["titulo"] . PHP_EOL;
print(tarea["titulo"])

# En PHP: $tarea["hecha"] = true;
tarea["hecha"] = True

# En PHP: $tarea["etiquetas"] = ["casa"];
tarea["etiquetas"] = ["casa"]
print(tarea)
print(len(tarea))

# El orden es el de inserción, como en PHP.
for clave in tarea:
    print(clave)
PHP 8.5index.php
<?php
declare(strict_types=1);

$tarea = ["titulo" => "Comprar pan", "prioridad" => 2, "hecha" => false];

$tarea["hecha"] = true;
$tarea["etiquetas"] = ["casa"];

echo count($tarea) . PHP_EOL;
echo json_encode($tarea) . PHP_EOL;
Pythonmain.py
import json

tarea = {"titulo": "Comprar pan", "prioridad": 2, "hecha": False}

tarea["hecha"] = True
tarea["etiquetas"] = ["casa"]

print(len(tarea))
print(json.dumps(tarea))

¿Cuándo usar un diccionario? Cuando quieres encontrar algo por un nombre o un identificador, no por su posición:

  1. Una tarea como registro: {"titulo": ..., "prioridad": ...}. Cada campo tiene nombre.
  2. Las tareas indexadas por id: tareas[7] te da la tarea 7 al instante, sin recorrer nada (en una lista tendrías que mirar una a una).
  3. Contar cosas: cuántas tareas hay por prioridad, cuántas veces sale cada etiqueta.
  4. Configuración y JSON: lo que llega de una API como JSON es, en Python, un diccionario. Es tu json_decode($texto, true).

¿Por qué? · En PHP no existe

¿Por qué buscar por clave es más rápido que recorrer una lista?

Porque el diccionario guarda cada clave en un sitio calculado a partir de ella (su hash). Buscar "Comprar pan" no recorre las tareas: salta directo al sitio. En una lista de un millón de elementos, x in lista los mira uno a uno; x in diccionario casi no tarda.

El array de PHP hace lo mismo por dentro, pero ahí no lo ves, porque lista y diccionario son el mismo tipo. En Python eliges tú: lista si importa el orden y la posición, diccionario si importa el nombre.

2 · Leer una clave: [] frente a get

Aquí está el cambio más importante respecto a PHP. Si en PHP pides una clave que no existe, obtienes un Warning y null, y el programa sigue. En Python, tarea["x"] con una clave que no existe lanza KeyError y el programa se para.

Pythonmain.py
tarea = {"titulo": "Comprar pan", "prioridad": 0}

# En PHP: echo $tarea["fecha"] ?? "sin fecha";
print(tarea.get("fecha", "sin fecha"))

# Sin valor por defecto, get devuelve None (el null de PHP).
print(tarea.get("fecha"))

# En PHP: var_dump(array_key_exists("prioridad", $tarea));
print("prioridad" in tarea)
print("fecha" in tarea)

# Con corchetes, una clave que falta es un error. try/except: módulo 07.
try:
    print(tarea["fecha"])
except KeyError as error:
    print("Falta la clave:", error)

# get devuelve el valor tal cual, aunque sea 0 (que es falso).
print(tarea.get("prioridad", 1))
PHP 8.5index.php
<?php
declare(strict_types=1);

$tarea = ["titulo" => "Comprar pan", "prioridad" => 0];

echo ($tarea["fecha"] ?? "sin fecha") . PHP_EOL;
var_dump(array_key_exists("prioridad", $tarea));
var_dump(isset($tarea["fecha"]));
echo ($tarea["prioridad"] ?? 1) . PHP_EOL;
Pythonmain.py
tarea = {"titulo": "Comprar pan", "prioridad": 0}

print(tarea.get("fecha", "sin fecha"))
print("prioridad" in tarea)
print(tarea.get("fecha") is not None)
print(tarea.get("prioridad", 1))
Quiero…En PHPEn Python
Leer una clave que sé que existe$a["x"]a["x"] (si falta, KeyError)
Leer con valor por defecto$a["x"] ?? 1a.get("x", 1)
¿Existe la clave?array_key_exists("x", $a)"x" in a
¿Existe y no es null?isset($a["x"])a.get("x") is not None
Todas las clavesarray_keys($a)list(a) o a.keys()
Todos los valoresarray_values($a)list(a.values())

¿Por qué? · En PHP no existe

¿Por qué una clave que falta es un error y no un null? En PHP es un aviso

En PHP, escribir mal una clave ($tarea["titlo"]) te da null y un Warning que a menudo ni miras. El null viaja por tu programa y estalla cinco funciones más allá, lejos del fallo real.

Python para en el sitio y te dice exactamente qué clave falta. Y si lo que quieres es «puede que falte y me da igual», lo dices tú: get. Es el mismo principio que en las listas: los errores tienen que verse pronto.

3 · Añadir, borrar, fusionar y agrupar

Asignar a una clave nueva la crea; asignar a una que existe la cambia. Para borrar, pop (devuelve el valor) o del. Y para fusionar dos diccionarios, update los junta cambiando el primero y el operador | crea uno nuevo.

Pythonmain.py
base = {"titulo": "Comprar pan", "prioridad": 1}
cambios = {"prioridad": 3, "hecha": True}

# En PHP: $nueva = array_merge($base, $cambios);
nueva = base | cambios
print(nueva)
print(base)

# update cambia el diccionario original, como $base = array_merge($base, $cambios).
base.update(cambios)
print(base)

# En PHP: $hecha = $base["hecha"]; unset($base["hecha"]);
hecha = base.pop("hecha")
print(hecha, base)

# pop con valor por defecto no falla si la clave no está.
print(base.pop("fecha", None))

# En PHP: unset($base["prioridad"]);
del base["prioridad"]
print(base)

setdefault(clave, valor) es el truco para agrupar: si la clave no existe la crea con ese valor, y siempre te devuelve lo que haya. Mira cómo se agrupan tareas por prioridad:

Pythonmain.py
tareas = [
    {"titulo": "Comprar pan", "prioridad": 1},
    {"titulo": "Pagar la luz", "prioridad": 3},
    {"titulo": "Regar", "prioridad": 1},
]

# En PHP: $por[$t["prioridad"]][] = $t["titulo"];
por_prioridad = {}
for t in tareas:
    por_prioridad.setdefault(t["prioridad"], []).append(t["titulo"])
print(por_prioridad)

# Contar con get: el 0 es el valor si la clave no existe todavía.
cuenta = {}
for t in tareas:
    cuenta[t["prioridad"]] = cuenta.get(t["prioridad"], 0) + 1
print(cuenta)
PHP 8.5index.php
<?php
declare(strict_types=1);

$tareas = [
    ["titulo" => "Comprar pan", "prioridad" => 1],
    ["titulo" => "Pagar la luz", "prioridad" => 3],
    ["titulo" => "Regar", "prioridad" => 1],
];

$porPrioridad = [];
foreach ($tareas as $t) {
    $porPrioridad[$t["prioridad"]][] = $t["titulo"];
}

echo json_encode($porPrioridad) . PHP_EOL;
Pythonmain.py
import json

tareas = [
    {"titulo": "Comprar pan", "prioridad": 1},
    {"titulo": "Pagar la luz", "prioridad": 3},
    {"titulo": "Regar", "prioridad": 1},
]

por_prioridad = {}
for t in tareas:
    por_prioridad.setdefault(t["prioridad"], []).append(t["titulo"])

print(json.dumps(por_prioridad))

¿Por qué? · En PHP no existe

¿Por qué hace falta setdefault? En PHP el array se crea solo

En PHP, $por[$k][] = $x crea la clave $k y el array interior sin avisar. En Python eso es un KeyError: no puedes hacer .append sobre algo que no existe. setdefault es la forma explícita de decir «créalo si falta».

Es más texto, pero te obliga a pensar en el caso «primera vez que veo esta clave». En el módulo 03 verás defaultdict y Counter, que lo hacen aún más corto.

Quiero…En PHPEn Python
Fusionar en uno nuevoarray_merge($a, $b) o $a + $ba | b (gana el de la derecha)
Fusionar cambiando a$a = array_merge($a, $b)a.update(b) o a |= b
Borrar una claveunset($a["x"])del a["x"] o a.pop("x", None)
Crear si falta$a["x"] ??= 0a.setdefault("x", 0)
Vaciar$a = []a.clear()

4 · Recorrer un diccionario

Recorrer un diccionario con for te da solo las claves. Para tener también el valor, usa .items(), que da pares (clave, valor) y los desempaquetas como en la lección de tuplas.

Pythonmain.py
tareas = {"Comprar pan": False, "Pagar la luz": True, "Regar": False}

# En PHP: foreach ($tareas as $titulo => $hecha) { ... }
for titulo, hecha in tareas.items():
    estado = "hecha" if hecha else "pendiente"
    print(f"{titulo}: {estado}")

# Solo las claves y solo los valores.
print(list(tareas.keys()))
print(list(tareas.values()))

# En PHP: count(array_filter($tareas))
print(sum(tareas.values()))
PHP 8.5index.php
<?php
declare(strict_types=1);

$tareas = ["Comprar pan" => false, "Pagar la luz" => true, "Regar" => false];

foreach ($tareas as $titulo => $hecha) {
    $estado = $hecha ? "hecha" : "pendiente";
    echo "$titulo: $estado" . PHP_EOL;
}
Pythonmain.py
tareas = {"Comprar pan": False, "Pagar la luz": True, "Regar": False}

for titulo, hecha in tareas.items():
    estado = "hecha" if hecha else "pendiente"
    print(f"{titulo}: {estado}")

5 · Comprensiones de diccionario y qué puede ser clave

Igual que con las listas, un diccionario nuevo se puede describir en una línea. La forma es {clave: valor for ... in ... if ...}. El uso más común es indexar una lista por id:

Pythonmain.py
tareas = [
    {"id": 7, "titulo": "Comprar pan", "hecha": False},
    {"id": 9, "titulo": "Pagar la luz", "hecha": True},
]

# En PHP: array_column($tareas, null, "id")
por_id = {t["id"]: t for t in tareas}
print(por_id[9]["titulo"])

# En PHP: array_column($tareas, "titulo", "id")
titulos = {t["id"]: t["titulo"] for t in tareas}
print(titulos)

# Con filtro: solo las pendientes.
pendientes = {t["id"]: t["titulo"] for t in tareas if not t["hecha"]}
print(pendientes)

# Dar la vuelta: de {id: titulo} a {titulo: id}.
al_reves = {titulo: id_tarea for id_tarea, titulo in titulos.items()}
print(al_reves)

Las claves pueden ser textos, números, booleanos o tuplas, pero no listas ni otros diccionarios (no son hashable: pueden cambiar, y entonces el sitio calculado dejaría de valer). Y a diferencia de PHP, 1 y "1" son claves distintas.

Pythonmain.py
# Una tupla (dia, hora) como clave: la agenda de tareas.
agenda = {
    ("lunes", 9): "Reunión",
    ("lunes", 12): "Comprar pan",
}
print(agenda[("lunes", 12)])

# En PHP "1" y 1 serían la misma clave. Aquí no.
claves = {1: "numero", "1": "texto"}
print(len(claves))

¿Por qué? · En PHP no existe

¿Por qué una lista no puede ser clave de un diccionario?

El diccionario coloca cada clave en un sitio calculado a partir de su contenido. Si la clave pudiera cambiar después de guardarla (una lista sí puede), su sitio calculado dejaría de coincidir y el diccionario perdería el valor sin avisar.

Por eso solo valen los tipos inmutables: textos, números, tuplas. Es la razón por la que existen las tuplas. En PHP las claves solo pueden ser int o string, así que el problema ni se plantea.

Hora de practicar

Retos · 0/4 resueltos

Reto 1 de 4

Recorre el diccionario

El diccionario tareas guarda cada título con su estado (True si está hecha). Recórrelo con .items() e imprime una línea por tarea con el formato Comprar pan: pendiente o Pagar la luz: hecha. Es el foreach ($tareas as $titulo => $hecha) de PHP.

Al pulsar Comprobar, unos tests ocultos prueban tu código en tu navegador, con Python 3.14.

Pythonmain.py · editable

Resumen

Lo que te llevas de esta lección

  1. dict es el array asociativo de PHP, con orden de inserción y claves de cualquier tipo inmutable (también tuplas).
  2. d["x"] con una clave que falta lanza KeyError; d.get("x", defecto) es el ?? de PHP y "x" in d, el array_key_exists.
  3. d | otro crea un diccionario nuevo (el array_merge), d.update(otro) cambia el original, y pop / del son el unset.
  4. setdefault crea la clave si falta: sirve para agrupar (d.setdefault(k, []).append(x)), que en PHP sale solo con $d[$k][] = $x.
  5. Recorre con .items() (foreach ($a as $k => $v)) y construye con {t["id"]: t for t in tareas} (el array_column).

Para recordarlo: «Pide, Junta, Recorre»

PPide
get en vez de [] si la clave puede faltar
JJunta
a | b · update · setdefault
RRecorre
for k, v in d.items()

Con un diccionario Pides (get), Juntas (|, update) y Recorres (items). Y para recordar el error: «los corchetes exigen, get pregunta».