Go Academy · Leçon

Chargement dynamique et symboles

Charger des plugins à l’exécution et appeler les symboles exportés

Chargement dynamique et symboles est une leçon Go Academy gratuite sur CoddyKit. Ceci est la leçon 3 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Go Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Go Academy comprend 4 leçons au total.

plugin.Open

plugin.Open(path) charge un fichier .so compilé. Il initialise les fonctions init() et les variables au niveau des paquets du module d’extension, puis rend les symboles disponibles.

p, err := plugin.Open("./plugins/mymodule.so")
if err != nil { log.Fatalf("load: %v", err) }

p.Lookup

p.Lookup(name) recherche un symbole exporté par son nom. La fonction renvoie une valeur de type any ; effectuez une assertion de type vers le type attendu.

sym, err := p.Lookup("NewProcessor")
if err != nil { log.Fatalf("lookup: %v", err) }
fn, ok := sym.(func() Processor)
if !ok { log.Fatal("wrong type") }

Charger plusieurs modules d’extension

Chargez chaque fichier .so d’un répertoire et enregistrez-les dans une boucle :

entries, _ := os.ReadDir("./plugins")
for _, e := range entries {
    if !strings.HasSuffix(e.Name(), ".so") { continue }
    p, err := plugin.Open("./plugins/" + e.Name())
    if err != nil { log.Printf("skip %s: %v", e.Name(), err); continue }
    loadPlugin(p)
}

Modèle de fonction fabrique

Les modules d’extension exportent une fonction fabrique (NewXxx() Processor) plutôt qu’une valeur, afin que l’hôte obtienne une nouvelle instance à chaque appel :

sym, _ := p.Lookup("NewProcessor")
factory := sym.(func() Processor)
proc := factory() // new instance

Gestion des erreurs lors de la recherche

Les erreurs de Lookup signifient que le symbole n’est pas exporté ou que le nom est incorrect. Gérez-les correctement : ignorez le module d’extension ou consignez l’erreur et poursuivez le chargement des autres.

plugin.Open est idempotent

Appeler plugin.Open deux fois avec le même chemin renvoie le même module d’extension. Le module d’extension n’est initialisé qu’une seule fois.

Chargement différé

Chargez les modules d’extension à la demande (lors de la première utilisation) plutôt qu’au démarrage afin de réduire le temps de démarrage. Utilisez un sync.Once par module d’extension pour garantir qu’il est chargé exactement une fois.

var mu sync.Mutex
var loaded = map[string]*plugin.Plugin{}

func getPlugin(path string) (*plugin.Plugin, error) {
    mu.Lock(); defer mu.Unlock()
    if p, ok := loaded[path]; ok { return p, nil }
    p, err := plugin.Open(path)
    if err != nil { return nil, err }
    loaded[path] = p
    return p, nil
}

Conventions de nommage des symboles

Utilisez des noms exportés en CamelCase commençant par une majuscule (la règle de visibilité de Go s’applique). Convention courante : Plugin pour la valeur principale ou New pour la fabrique.

Gestion des paniques des modules d’extension

Si un module d’extension déclenche une panique, le middleware recover de l’hôte peut l’intercepter, mais les goroutines du module d’extension peuvent se retrouver dans un état indéfini. Consignez l’erreur et ignorez le module d’extension ; ne réessayez pas.

Validation des métadonnées du module d’extension

Après le chargement, vérifiez un symbole de métadonnées (par exemple, PluginVersion string) afin de valider la compatibilité avant l’enregistrement :

ver, _ := p.Lookup("PluginVersion")
if *ver.(*string) != expectedVersion { log.Fatal("incompatible") }

Vérification rapide

Que se passe-t-il si vous appelez plugin.Open deux fois avec le même chemin ?

Récapitulatif : chargement dynamique et symboles

Points clés :

plugin.Open charge un fichier .so ; p.Lookup renvoie any → effectuez une assertion de type
Chargez les modules d’extension d’un répertoire dans une boucle pour créer un système de modules d’extension
plugin.Open est idempotent ; init() s’exécute une seule fois par chemin
Privilégiez les fonctions fabriques aux symboles de valeurs pour obtenir de nouvelles instances

Questions Fréquemment Posées

La leçon « Chargement dynamique et symboles » est-elle gratuite ?

Oui — le texte complet de « Chargement dynamique et symboles » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Go Academy, passe à CoddyKit PRO. Le cours Go Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Chargement dynamique et symboles » ?

Charger des plugins à l’exécution et appeler les symboles exportés Tu pratiques Go Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Go Academy ?

Aucune expérience préalable n'est requise. Go Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 3 sur 4.

Combien de temps prend la leçon « Chargement dynamique et symboles » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Go Academy ?

Oui. Chaque leçon Go Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

← Retour à Go Academy