Composer + github - die Grundlage

**lionel** · 04.12.2013, 10:24

Hallo,

Ich möchte meine Erweiterungen für Composer vorbereiten.

Was ich gemacht habe :

[ OK ] github + hook to packagist
[ OK ] composer.json (Ich bin mir nicht sicher, ob es richtig ist : https://github.com/lionel-m/galerie/.../composer.json)
[ OK ] packagist account

Das Ergebnis : https://packagist.org/packages/lionel/galerie

1. Es gibt den Link "Connect your github account" in den Einstellungen von packagist aber sie sagen nicht, für was diese Option nützlich ist... Sie wissen ?
2. Ich habe die Erweiterung "composer" in Contao 3.2.1 installiert. Ich kann meine Erweiterung finden aber nicht installieren... (Es gibt : "Mark package to install" aber...)
3. Muss ich diese Information (Code unten) hinzufügen oder nur, wenn der Name der Hauptordner nicht standard ist ? (system)

Code:

"autoload": {
        "classmap": ["src/"]
    },

Vielen Dank im Voraus für Ihre Hilfe !

**xtra** · 04.12.2013, 10:50

Code:

    "extra": {
        "contao": {
            "symlinks": {
                    ".": "system/modules/galerie"
            }
        }
    }

Wyrde ich aendern in:

Code:

    "extra": {
        "contao": {
            "sources": {
                    "": "system/modules/galerie"
            }
        }
    }

Mit ersterem gab es lustige Probleme unter Windows.

Deine Erweiterung kannst du jedoch nicht installieren, da du composer zwar sagst, dass es sich um ein contao-module handelt (siehe "type") jedoch nicht, wie dieser installiert wird.

Dazu musst du in deinen require noch unseren installer angeben.
Vgl. hierzu unsere demo composer.json:
https://github.com/contao-community-.../composer.json

Die autoload Informationen sind notwendig, wenn du nicht den Contao autoloader via autoload.php verwenden willst.

**lionel** · 04.12.2013, 16:55

Danke für die Hilfe. Ich habe die Datei aktualisiert : https://github.com/lionel-m/galerie/.../composer.json

Jetzt das Problem ist, dass alle Dateien in "modules/galerie" kopiert sind (files/..., system/..., readme.md, usw) wie im Github-Repository dargestellt.

Aber ich habe "userfiles" benützt und dass es funktioniert :

Code:

"extra": {
        "contao": {
            "sources": {
                "": "system/modules/galerie"
            },
            "userfiles": {
                "": "files/"
            }
        }
    }

Was habe ich falsch gemacht ?

Andere Frage :

Gemäß den Parametern, die Erweiterung verwendet immer die letzten commit (service hooks von github)... Wäre es möglich, nur ein Update für jede Veröffentlichung des "Release" haben ?

Vielen Dank

**webstar** · 04.12.2013, 17:14

Zitat von lionel

Danke für die Hilfe. Ich habe die Datei aktualisiert : https://github.com/lionel-m/galerie/.../composer.json

Jetzt das Problem ist, dass alle Dateien in "modules/galerie" kopiert sind (files/..., system/..., readme.md, usw) wie im Github-Repository dargestellt.

Aber ich habe "userfiles" benützt und dass es funktioniert :

Code:

"extra": {
        "contao": {
            "sources": {
                "": "system/modules/galerie"
            },
            "userfiles": {
                "": "files/"
            }
        }
    }

Was habe ich falsch gemacht ?

Als erster Parameter wird der Ordner angegeben, der kopiert werden. soll. Man kann dann auch mehrere Pfade definieren, falls benötigt. Also je nach Aufbau der Erweiterung:

Code:

"extra": {
        "contao": {
            "sources": {
                "system/modules/galerie": "system/modules/galerie"
            },
            "userfiles": {
                "files/galerie": "files/galerie"
            }
        }
    }

**lionel** · 04.12.2013, 18:05

Danke. Es funktioniert jetzt !

PS: Wenn wir eine Erweiterung löschen, werden die Dateien in den Ordner files nicht gelöscht. Ist es gewünscht ?

**lionel** · 04.12.2013, 22:39

Zitat von lionel

Gemäß den Parametern, die Erweiterung verwendet immer die letzten commit (service hooks von github)... Wäre es möglich, nur ein Update für jede Veröffentlichung des "Release" haben ?

Ich habe nichts gefunden... Es wäre schön, ein Update möglich für jede "release" und nicht für jede "commit" zu haben.

**BugBuster** · 04.12.2013, 23:55

dafür setzt du dann per "git tag -a 1.2.7 -m "Version 1.2.7" vor dem git push und markierst die Version damit. Die kann man dann später auswählen.
das alle commits auch ankommen bleibt aber so.

Wie man das per dev branch trennen könnte und auch verständlich machen kann, das fehlt mir auch noch an Wissen.

**lionel** · 05.12.2013, 09:29

The package uses the dev-master branch. In this case we can use a develop branch for working and then pushed the code when we want to make the changes available...

But yes, it would be nice to use only commits that are tagged.

**gerritlo** · 20.06.2014, 16:41

Hallo zusammen,

also ich bekomms auch nicht hin. Hier meine composer.json (https://github.com/gerritlo/glo_immo.../composer.json).

Immer wenn ich das Paket installiere, werden meine Dateien unter Vendor abgelegt, auch die require-Anweisungen werden geladen, mein Modul wird aber nicht von Contao geladen. Woran kann das liegen?

Danke und Grüße

**cliffparnitzky** · 20.06.2014, 16:47

Also,
also Typ sollte das "contao-modul" stehen:

Code:

"type":"contao-module",

und das unter 'extra ... contao ... sources' wird auch nicht gut sein so.

Dort eher einen Ordner im Github Repo anlegen und den dort verlinken ... das Ziel dann auch nicht absolut wählen ... also den führen "/" weg.

Gruß, Cliff

**gerritlo** · 20.06.2014, 16:52

Wie meinst du das mit Ordner anlegen? Wo ich den kompletten Code reinlege?

**xtra** · 20.06.2014, 16:54

Bitte auch das composer-plugin und nicht den composer-installer requiren.

**gerritlo** · 20.06.2014, 17:26

Sorry, aber es geht auch mit geänderter composer.json nicht.

Hier ist mein Paketname: gerritlo/glo_immoconnector
und mein Repo: https://github.com/gerritlo/glo_immoConnector/

Danke

**BugBuster** · 20.06.2014, 20:59

Du hast auf GitHub keine Version (Tag) definiert, somit ist keine Versionsnummer bei Packagist bekannt.
Eine Lizenz solltest du auch angeben (das meckert Packagist übrigens auch rot an!)
z.b.

Code:

"license":"LGPL-3.0+",

Und, was passiert denn beim Installationsversuch? Wird die überhaupt gefunden?

**gerritlo** · 20.06.2014, 21:56

Klar, wird gefunden, in das vendor Verzeichnis geladen und laut composer ein Symlink angelegt, den finde ich aber nicht, bzw. Wird das Modul auch nicht geladen. Tag und Lizenz kommt noch.

**ciaobello** · 01.07.2014, 12:16

Zitat von BugBuster

dafür setzt du dann per "git tag -a 1.2.7 -m "Version 1.2.7" vor dem git push und markierst die Version damit. Die kann man dann später auswählen.
das alle commits auch ankommen bleibt aber so.

Wie man das per dev branch trennen könnte und auch verständlich machen kann, das fehlt mir auch noch an Wissen.

Ich habe gesehen das Du mittlerweile die Repos auch aufteilst nach dev und master. Hast vielleicht noch ein Hinweis hier (oder Link)?
Danke schon mal für die bestehenden Infos.

**BugBuster** · 01.07.2014, 21:18

Das sind meist alte dev Branches.
Da wo ein dev oder develop Branch mit composer.json existiert, liegen RC Versionen, die sind dann so getaggt: 3.2.0-RC1
Das versteht wiederum Packagist.org und macht auch ein RC Versionen draus und gibt das als solche weiter ins Backend.

In der composer.json kann man selbst wohl auch angeben, bei welcher Version es sich um eine dev handelt bzw. welche Version eine dev ist.
Also die 1.0.0 stable hat dann z.B. einen Eintrag, das die 1.1.0 eine dev ist.
Das habe ich aber noch nicht richtig kapiert glaube ich. Muss ich mal mit meinem Projekt Spielwiese ein wenig testen.

**BugBuster** · 06.07.2014, 00:20

Zitat von gerritlo

Klar, wird gefunden, in das vendor Verzeichnis geladen und laut composer ein Symlink angelegt, den finde ich aber nicht, bzw. Wird das Modul auch nicht geladen. Tag und Lizenz kommt noch.

Der Symlink sollte in system/modules angelegt werden, damit Contao das findet.
Fehlt der Link, kann also Contao nichts finden.