Mis apuntes · Aprende Go 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 13 de 36 · De clases a structs ✦ WebMCP implementado

Métodos y receptores: el $this de Go

9 min de lectura 4 retos

Un struct guarda datos; los métodos le dan comportamiento. En Go no se escriben dentro del struct sino al lado, y en vez de $this cada método dice cómo se llama su tarea: el receptor. Elegir bien entre receptor por valor o por puntero es la decisión más importante de este módulo.

¿De dónde vienen los nombres?

receptor = del inglés receiver (el que recibe)
La variable entre paréntesis antes del nombre del método: la tarea que «recibe» la llamada. Es tu $this, pero con el nombre que tú elijas.
Stringer = String + er (el que convierte en string)
En Go, una interfaz de un solo método se nombra con el método más -er: Stringer tiene String(), Reader tiene Read(). Es el Stringable de PHP 8.
En 4 ideas
1/4

Un método es una función con un receptor delante: func (t Tarea) Resumen() string. La t es tu $this, con el nombre que tú le pongas.

1 · Un método es una función con receptor

En PHP los métodos van dentro de la clase y usan $this para llegar a sus propiedades. En Go los métodos se escriben fuera del struct, como funciones normales, pero con un paréntesis extra delante del nombre: el receptor.

PHP 8.5tarea.php
<?php
declare(strict_types=1);

final class Tarea
{
    public function __construct(
        public int $id,
        public string $titulo,
        public bool $hecha = false,
    ) {}

    public function resumen(): string
    {
        $marca = $this->hecha ? "x" : " ";
        return "[{$marca}] {$this->titulo}";
    }
}

$t = new Tarea(1, "Comprar pan");
echo $t->resumen() . PHP_EOL;
Gomain.go
package main

import "fmt"

type Tarea struct {
    ID     int
    Titulo string
    Hecha  bool
}

// (t Tarea) es el receptor: t hace de $this.
// En PHP: public function resumen(): string
func (t Tarea) Resumen() string {
    marca := " "
    if t.Hecha {
        marca = "x"
    }
    return "[" + marca + "] " + t.Titulo
}

func main() {
    t := Tarea{ID: 1, Titulo: "Comprar pan"}
    // En PHP: echo $t->resumen();
    fmt.Println(t.Resumen())
}

El receptor suele llamarse con la primera letra del tipo (t para Tarea, l para Lista). Nada de this ni self: es una convención de Go para que el código sea corto.

Equivalencia POO · PHP → Go

Lo que en PHP vive dentro de la clase, en Go vive al lado del struct, en el mismo paquete.

PHPGoQuién lo ve
public function resumen()func (t Tarea) Resumen()Cualquier paquete (mayúscula)
private function marca()func (t Tarea) marca()Solo el mismo paquete (minúscula)
$this->titulot.TituloEl receptor es una variable más, con el nombre que elijas
public static function nueva()func NuevaTarea()Función del paquete, sin receptor
self::MAXconst MaxTareas = 100Constante del paquete
public function __toString()func (t Tarea) String() stringLo usa fmt al imprimir

2 · Receptor por valor o por puntero

Aquí está la trampa más grande del módulo para alguien de PHP. Recuerda el módulo 03: en Go, pasar un struct lo copia. El receptor es un parámetro más, así que con (t Tarea) el método recibe una fotocopia de la tarea.

Si tachas una fotocopia, el original sigue igual. Mira:

Gomain.go
package main

import "fmt"

type Tarea struct {
    ID     int
    Titulo string
    Hecha  bool
}

// Receptor por valor: t es una copia
func (t Tarea) CompletarCopia() {
    t.Hecha = true
}

// Receptor por puntero: t apunta a la tarea original
func (t *Tarea) Completar() {
    t.Hecha = true
}

func main() {
    a := Tarea{ID: 1, Titulo: "Comprar pan"}
    a.CompletarCopia()
    fmt.Println("por valor:", a.Hecha)

    b := Tarea{ID: 2, Titulo: "Llamar al banco"}
    // En PHP: $b->completar();
    b.Completar()
    fmt.Println("por puntero:", b.Hecha)
}

CompletarCopia compila y se ejecuta sin queja, pero no hace nada. Completar, con el asterisco, cambia la tarea de verdad.

¿Por qué? · En PHP no existe

¿Por qué tengo que elegir? En PHP $this siempre cambia el objeto

En PHP un objeto se pasa siempre «por referencia» (como un puntero), así que $this->hecha = true cambia el objeto original. Cómodo, pero cualquier método puede cambiarte el objeto a tus espaldas, y por eso existen readonly y los objetos inmutables.

Go te obliga a decirlo en la firma:

  • (t Tarea): «solo leo». Quien llama sabe que su tarea no va a cambiar, sin leer el código del método.
  • (t *Tarea): «puedo cambiarla». Queda escrito y a la vista.

Es la misma información que en PHP solo te da readonly, pero método a método.

3 · ¿Cuándo uso puntero?

Una regla corta para no dudar:

  1. Si el método cambia algún campo → puntero, (t *Tarea).
  2. Si el struct es grande (muchos campos, arrays) → puntero, para no copiarlo en cada llamada.
  3. Si algún método del tipo usa puntero → mejor que todos lo usen, para no liarse.
  4. Si es pequeño y solo se lee (como Prioridad en la lección siguiente) → por valor.

Hay un sitio donde el & automático no llega: los elementos de un map. Go no deja apuntar dentro de un map, así que esto no compila. Mensaje real:

Gomain.go
tareas := map[int]Tarea{1: {ID: 1, Titulo: "Comprar pan"}}
tareas[1].Completar()
./main.go:14:10: cannot call pointer method Completar on Tarea

La salida es sacar la tarea, cambiarla y volver a guardarla, o guardar punteros en el map (map[int]*Tarea):

Gomain.go
t := tareas[1]
t.Completar()
tareas[1] = t

4 · Sin static: funciones del paquete

En PHP usas static para lo que pertenece a la clase y no a un objeto: fábricas, contadores, utilidades. En Go no existe. Su sitio es el paquete: una función o una variable de nivel superior, fuera de cualquier struct.

Gomain.go
package main

import "fmt"

type Tarea struct {
    ID     int
    Titulo string
}

// En PHP: private static int $siguienteId = 1;
var siguienteID = 1

// En PHP: public static function nueva(string $titulo): self
func NuevaTarea(titulo string) Tarea {
    t := Tarea{ID: siguienteID, Titulo: titulo}
    siguienteID++
    return t
}

func main() {
    a := NuevaTarea("Comprar pan")
    b := NuevaTarea("Llamar al banco")
    fmt.Println(a.ID, a.Titulo)
    fmt.Println(b.ID, b.Titulo)
}

5 · String(): tu __toString()

Si un tipo tiene un método String() string, fmt.Println, fmt.Printf con %v y fmt.Sprint lo usan solos para imprimirlo. Es el __toString() de PHP: no lo llamas tú, lo llama quien imprime.

Gomain.go
package main

import "fmt"

type Tarea struct {
    ID     int
    Titulo string
    Hecha  bool
}

// En PHP: public function __toString(): string
func (t Tarea) String() string {
    estado := "pendiente"
    if t.Hecha {
        estado = "hecha"
    }
    return fmt.Sprintf("#%d %s (%s)", t.ID, t.Titulo, estado)
}

func main() {
    t := Tarea{ID: 1, Titulo: "Comprar pan"}
    // En PHP: echo $t;
    fmt.Println(t)
    fmt.Printf("Tarea: %v\n", t)
}

Hora de practicar

Retos · 0/4 resueltos

Reto 1 de 4

La casilla de la tarea

Completa el método (t Tarea) Casilla() string: devuelve [x] <titulo> si la tarea está hecha y [ ] <titulo> si no. Por ejemplo, Tarea{Titulo: "Comprar pan"}.Casilla() devuelve [ ] Comprar pan. Es un método de PHP que lee $this->hecha y $this->titulo.

Al pulsar Comprobar, unos tests ocultos prueban tu código con el compilador oficial de Go.

Gomain.go · editable

Resumen

Lo que te llevas de esta lección

  1. func (t Tarea) Resumen() es un método; t es tu $this con el nombre que quieras (en PHP, public function resumen()).
  2. Receptor por valor = copia, solo lectura; receptor puntero (t *Tarea) = cambia el original (en PHP, $this->hecha = true).
  3. Si un método cambia la tarea y lleva receptor por valor, compila y no hace nada: revisa el asterisco.
  4. Sin static: fábricas y estado compartido son funciones y variables del paquete (en PHP, Tarea::nueva()).
  5. String() string es tu __toString(): fmt.Println(t) lo usa solo.

Para recordarlo: «Si cambia, asterisco»

Antes de escribir un método pregúntate: ¿cambia la tarea? Si la respuesta es sí, el receptor lleva asterisco (*Tarea). Si solo la lee, va sin él. Y para imprimirla bonita, String() es tu __toString().