Steg-för-steg guide när du ber om support

Detta är en steg-för-steg guide som är tänkt att förklara på ett vattentätt sätt vilka inställningar du behöver göra när du ber om support på Coppermines support forum.

Vi antar att du har satt strikta behörigheter, så vi går igenom det här lite mer komplicerat än vad som faktiskt är nödvändigt för de flesta installationer: instruktionerna nedan är tänkta att tillåta uppladdning av felsökning för supportern även om resten av användarna i ditt galleri inte har tillåtelse att ladda upp eller om du inte tillåter användarregistrering överhuvud taget. Om du kan systemet, kan du strunta i steget som förklarar hur man skapar en extra grupp om alla dina användare i alla fall har tillåtelse att ladda upp. Poängen är att supporten ska kunna gå igenom uppladdningen tills han/hon kan se vad som faktiskt går fel under uppladdningsstadiet.

• Logga in som administratör

  Gå till din Coppermine sida och logga in som administratör

• ´Skapa grupp för uppladdning

  Instruktionerna nedan om hur du skapar en grupp gäller bara om du kör Coppermine i fristående läge. Om du har länkat ditt Coppermine galleri, använd den applikation du länkat till för att skapa gruppen.

  • Gå till kontrollpanelen för grupper genom att klicka på motsvarande länk i administratörsmenyn
  • Bläddra till slutet av sidan
  • Klicka på knappen "Skapa ny grupp"
  • En ny tabellrad kommer att synas i slutet av kontrollpanelen för gruppen. Klicka i namnfältet och ange ett vettigt namn för gruppen, t.ex. "uppladdare"
  • Bläddra till slutet av sidan
  • Skicka formuläret genom att klicka på knappen "Utför ändringar"

• Bevilja uppladdningsbehörighet till uppladdningsgruppen

  Instruktionerna nedan om hur man sätter behörighet till en grupp gäller både för fristående och länkade gallerier.

  • Gå till kontrollpanelen för gruppen genom att klicka på motsvarande länk i administratörsmenyn
  • För uppladdningsgruppen som du skapade i föregående steg, sätt växeln "Tillåtet" till "Jas" i kolumnen "Uppladdning av publika album". Sätt växeln "Godkännande" till "Nej" i den tabellcellen.
  • Bläddra till slutet av sidan
  • Skicka formuläret genom att klicka på knappen "Utför ändringar"

• Skapa ett testanvändarkonto som inte är administratör

  Instruktionerna nedan om hur man skapar en användare gäller bara om du kör Coppermine i fristående läge. Om du har länkat Coppermine till en annan applikation, använd den för att skapa testanvändarkontot.

  • Gå till användarhanteraren genom att klicka på motsvarande länk i administratörsmenyn
  • Bläddra till slutet av sidan
  • Klicka på knappen "Skapa ny användare"
  • På följande bild, ange ett användarnamn som är lätt att komma ihåg och skriva - vi rekommenderar något enkelt som "test", helst utan stora bokstäver.
  • Sätt ett enkelt lösenord - kan vara detsamma som användarnamnet.
  • Tilldela användaren den grupp "Uppladdare" som du skapade förut - säkerställ att listrutan för användargruppen har värdet "Uppladdare" (eller det namn som du valde för den gruppen).
  • Bläddra till slutet och skicka formuläret.

• Skapa ett album dit de uppladdade filerna kan hamna

  Så här långt har vi skapat en anpassad grupp som har behörighet att ladda ner filer till publika album, men vi har inte sagt vilket album uppladdningen får gå till. Vi måste skapa ett album först.

  • Gå till albumhanteraren genom att klicka på motsvarande länk i administratörsmenyn
  • Välj en kategori som testalbumet ska skapas i - välj kategori genom att använda listrutan överst på albumhanteraren. För enkelhetens skull rekommenderar vi att du skapar testalbumet i galleriets rot-mapp (välj "* Ingen kategori *" från listrutan).
  • Klicka på knappen "Nytt album" i slutet på sidan
  • Ett registreringsfält visas. Ange namnet på det nya albumet som "test album" och skicka formuläret genom att klicka på knappen OK

• Tillåt uppladdningar till test albumet

  Nu finns albumet dit uppladdningarna ska gå, men ännu har ingen utom administratören tillåtelse att ladda upp filer dit. Låt oss tillåta uppladdningar till albumet.

  • Gå till galleriet index genom att klicka på länken "Album lista" i den vanliga gallerinavigationen
  • Navigera till den kategori som du skapade testalbumet i (om du gjorde som vi föreslog och skapade testalbumet i galleriets rot, bör du redan befinna dig där du ska vara, så då behöver du inte göra något här)
  • Klicka på knappen "Egenskaper" vid sidan om den tomma miniatyrbilen som representerar testalbumet
  • På sidan album egenskaper sätt "Besökare kan ladda upp filer" till "Ja"
  • Om ditt galleri har mycket trafik och du inte vill att dina besökare ska se att det finns ett testalbum, välj "Medlemmar i gruppen 'Uppladdare' " från listrutan "Besökare kan ladda upp filer"
  • Bläddra till slutet och skicka formuläret genom att klicka på knappen "Uppdatera album"

• Sätt "Standard uppladdningsmetod" till "Enkel"

  • Gå till konfigurationspanelen
  • Bläddra till avsnittet "Användarinställningar" och utöka alla genom att klicka på det
  • Sätt Standarduppladdningsmetod till "Enkel - en fil åt gången"
  • Bläddra till slutet av sidan
  • Spara de nya inställningarna genom att klicka på "Spara ny konfiguration"

• Aktivera "debug läge"

  • Gå till konfigurationspanelen
  • Bläddra till avsnittet "Inställningar för underhåll" och utöka alla genom att klicka på det
  • Aktivera debug läge för alla genom att klicka på "Ja: Alla" på raden "Aktivera debug läge"
  • Lämna visning av notiser avstängt - om kryssrutan "Visa notiser i debug läge" är förbockad, bocka av den (notiser är bara tänkta för utvecklare - om du inte har en aning om vad de betyder, utelämna dem permanent)
  • Bläddra till slutet av sidan
  • Spara de nya inställningarna genom att klicka på "Spara ny konfiguration"

• Testa uppladdningen genom att använda det nya testanvändarkontot

  Du kan frestas att gå vidare genom att be om support redan nu, men vänta ett ögonblick: du har inte provat själv ännu att allt fungerar som förväntat. Du vill inte påbörja en supportförfrågan för att bara bli tillsagd att "gör din hemläxa först" (för det är vad som kommer att hända om du inte har gjort som vi föreslår här). Så här gör du:

  • Logga ut från Coppermine (eller använd en annan webbläsare parallellt) om du är inloggad som administratör
  • Logga in genom att använda det testanvändarkonto som du skapade tidigare. Om det misslyckas kontrollera uppgifterna för testanvändarkontot när du är inloggad som administratör.
  • Klicka på "Ladda upp fil". Om du inte har någon uppladdningslänk så har du inte satt behörigheterna rätt - gå igenom ovanstående steg noggrant.
  • På bilden för filuppladdning, välj testalbumet från listrutan "Album". Om du inte kan välja testalbumet, så har du gjort ett misstag när du satte upp uppladdningsbehörigheterna
  • Klicka på knappen "Bläddra..." och navigera till en liten men bra jpg-fil på din hårddisk. Anta inte att vilken som helst bild duger: om du är tveksam, ladda ner en testbild från Coppermines demo sida
  • Skicka formuläret genom att klicka på knappen "Ladda upp fil"

  I den bästa av världar fungerar allt som förväntat - din uppladdning kommer att fungera och du kommer att se din uppladdade bild inbäddad i Coppermine sidan. Om så är fallet, kommer http-uppladdningar att fungera. Om inte, så bör du få ett felmeddelande som förklarar vad det är för fel. Om du inte kan förstå vad felmeddelandet betyder, men du kunde utföra alla ovanstående steg inklusive det sista (skicka uppladdningsformuläret), så kan du gå vidare och be om hjälp på Coppermines supportforum . Du är välkommen att be om hjälp också om http-uppladdning fungerar men du behöver hjälp med en annan uppladdningsmetod.

• Be om hjälp på Coppermines support forum

  • Gå till Coppermines supportforum
  • Registrera ett nytt konto om du inte redan har ett och logga med det kontot på Coppermines supportforum.
  • Säkerställ att du läst forumets regler innan du gör ett inlägg (en länk till reglerna finns i forumets navigation)
  • Starta en ny tråd på det supportforum som hör ihop med din version av Coppermine. Eftersom du läser dokumentationen för cpg1.5.x, använder du troligtvis den versionen så du bör skapa din tråd på underavdelningen som hanterar den versionen. Att göra ett inlägg på en annan version än den man använder duger inte och skapar irritation både för dig och för supporten. Eftersom du har problem med uppladdning så bör du göra ditt inlägg i det forum som hanterar uppladdningsfrågor.
  • Kom ihåg att bifoga en länk till ditt galleri i ditt inlägg. Om ditt galleri har innehåll för vuxna (lite naket går under den kategorin också), lägg med en varning till din länk
  • Ange det detaljer om ditt testanvändarkonto (användarnamn och lösenord) som du satte innan
  • Det är en bra ide att visa supporten att du hör försökt först själv innan du bad om hjälp - förklara vad som faktiskt blev fel, hur långt du kom, vilket felmeddelande du fick osv.

Exempel på begäran om support

Felmeddelande: failed to create stream: Operation not permitted

Impossible to move somepic.jpg to albums/userpics/
Warning: move_uploaded_file(/tmp/phpezCYKr)
[function.move-uploaded-file]: failed to create stream: Operation not permitted

Impossible to move X to Y

Impossible to move somepic.jpg to albums/userpics/XXXXX/

Felmeddelande: failed to open dir: No such file or directory

Warning: opendir(./albums/edit): failed to open dir: No such file or directory

Felmeddelande: Sorry there is no album where you are allowed to upload files

Tyvärr finns det inget album dit du får ladda upp filer

Felmeddelande: Allowed memory size of X bytes exhausted

Fatal error: Allowed memory size of XXXXXXX bytes exhausted at (null):0 (tried to allocate XXXX bytes) in /var/www/html/include/picmgmt.inc.php

Felmeddelande: Exec() has been disabled

Exec() har inaktiverats

Felmeddelande: Not a GD extension

Inte en GD ändelse

Felmeddelande: Error executing ImageMagick - Return value 127

Filen 'albums/userpics/10001/somepic.jpg' kan inte läggas till i albumet. Fel vid körning av ImageMagick - Return value 127

Felmeddelande: PHP running on your server does not support the GD image library

PHP som körs på din server stöder inte GD bildbibliotek, kontrollera med ditt webbhotell om ImageMagick är installerat.

Felmeddelande: No file was uploaded !

Ingen fil laddades upp! Om du verkligen hade valt en fil att ladda upp, kolla att servern tillåter filuppladdningar...

Felmeddelande: Destination directory X is not writable by the script

Scriptet kan inte skriva till destinationsmappen albums/userpics/XXXXX/ 

PHP konfigurationsfilen php.ini

Saker att kontrollera

Om du har ett webbhotell, så måste du konsultera supporten för webbhotellet angående följande inställningar. Du kan granska (men inte ändra) dessa inställningar på din phpinfo sida.

1. max_input_time

   60 sekunder är standard för den tidsgräns som gäller för att ladda upp filer.
   I denna tidsgräns ingår den tid det tar för filerna att ladda upp, så om du överskrider den gränsen så kommer filen inte att analyseras och webbservern kommer inte att få något svar. Du kan komma runt det med att försöka ladda upp mindre och färre filer, eller så kan du försöka ladda upp via bredband. Den bästa lösningen, förstås, är att utöka tidsgränsen till något mer i samstämmighet med dina behov.

2. upload_max_filesize

   2MB är standard filstorlek för individuella filer.

3. post_max_size

   8MB är standard för en begäran om inlägg.

4. memory_limit

   8MB är standardstorlek för minne. Läs på om Minnesanvändning under skalning för instruktioner om hur du ändrar denna inställning och kringgår felmeddelanden relaterade till att minnesgränsen nåtts.

5. LimitRequestBody

   512KB är standardgräns. (i huvudsak ett problem på Redhat/Apache system. Finns i /etc/http/conf.d)
   Generellt, upload_max_filesize < post_max_size < memory_limit för att uppladdningar ska fungera korrekt. Coppermine kan varna dig om en fil överskrider upload_max_filesize, men den kan inte varna dig om den totala storleken för alla filer överskrider postgränsen eller minnesgränsen.

6. file_uploads

   Detta bestämmer om PHP ska tillåta uppladdningar eller inte. Det måste vara inställt på "On".

7. upload_tmp_dir

   Detta anger den temporära mapp dit PHP lagrar uppladdade filer.
   Det vanligaste problemet med den här inställningen är en open_basedir varning. I den här situationen har din serveradministratör begränsat de filer som PHP kan arbeta med till en speciell mapp. Om han/hon inte skapar eller anger en temporär mapp inom open_basedir begränsningar, kommer PHP att försöka använda operativsystemets temporära mapp, och den kommer att få bakläxa av begränsningarna i open_basedir.

Uppladdningsmekanismer/metoder

En del noteringar om olika typer av uppladdningsmekanismer som funnits sedan cpg1.3.x (eller senare):

Multipla HTTP uppladdningar har designats för att hantera ett mindre antal filer. Därför är de inte väl lämpade att ladda upp många filer om du inte kör din egen webbserver och har kontroll över php.ini konfigurationen.

Om du tänker ladda upp mer än 15 eller 20 filer åt gången, bör du överväga processen batchuppladdning eller XP Publisher verktyget. Båda har sina egna för- och nackdelar.

Batchuppladdninsprocessen är snabb, men kräver sin tribut av servern och den kan därför få timeout som orsakar att dina uppladdningar avslutas i förtid. XP Publisher, å andra sidan är avsevärd långsammare men belastar inte servern lika mycket. Det kringgår också många av de fallgropar som orsakas av begränsningar i php.ini konfigurationen genom att ladda upp varje fil som ingår i batchen som en separat fil.

Andra alternativ till uppladdningar (som klientbaserade agenter som JUpload eller liknande) kan tillhandahållas av tredje-part - du uppmuntras att se på dessa också, men kom ihåg att Coppermines utvecklare bara kan ge begränsad support för tredje-parts bidrag.

Kom ihåg dock att före du försöker några av de alternativa uppladdningsmetoderna så måste du försäkra dig om att den initiala uppladdningsmetoden "http uppladdning" fungerar - om det inte gör det måste du rätta det först; det är inte vettigt att försök en alternativ uppladdningsmetod om själva kärnuppladdningsmekanismen inte fungerar.

Minnesanvändning under skalning

Det finns (åtminstone i teorin) ingen begränsning i Coppermine vad gäller filstorlek eller dimensioner som scriptet kan hantera. Det finns emellertid åtminstone en begränsning på webbservern: omskalning av bilder (för att skapa medelstora bilder och/eller miniatyrbilder) förbrukar minne och bränner CPU cykler.

Om omskalningsprocessen förbrukar upp för mycket minne, får du vanligtvis felmeddelandet Fatal error: Allowed memory size of XXXXXXX bytes exhausted at (null):0 (tried to allocate XXXX bytes) in /var/www/html/include/picmgmt.inc.php eller liknande.

För att förhindra att servern kraschar, har serveradministratören begränsat mängden av minne som PHP scriptet kan använda. Detta görs genom att använda parametern memory_limit.

Du kan frestat att tro att minnesanvändningen motsvarar den filstorlek en bild använder på filsystemsnivå, men så är det inte: det vanliga filformatet JPEG är komprimerat, så om servern laddar en JPEG fil i minnet, använder den mycket mer RAM än vad som används på filsystemsnivå.

För att beräkna mängden minne en bild använder, multiplicerar du pixlarnas bredd och höjd, och sedan multiplicerar du resultatet med antalet basfärger(RGB - 3, CMYK - 4). Till slut dividerar du med 1,048,576 (2²⁰) för att få minnesanvändning i MB.

Här är en del vanliga bildupplösningar och deras minnesanvändning i GD (med RGB):

Kom ihåg när du använder ovanstående siffror, att du måste ta hänsyn till mängden minne som används av resten av Coppermine också.

som du ser, kan minnesanvändningen för bilder producerade av moderna digitalkameror lätt vara mer än vad webbservern kan hantera, även vid användning av enkel filuppladdning (för att inte tala om konsumtionen när man processar flera bilder genom att använda batch-uppladdning), så det rekommenderas att bilderna skalas om på den lokala datorn innan uppladdning sker: om servern helt enkelt inte kan processa de uppladdade bilderna, är det liten mening med att skylla på scriptet (Coppermine) eller be om hjälp på supportforumet: Coppermines utvecklingsteam kan inte hitta någon bot för den teknologi som används av webbservrar. Använd webbservern för det den har designats för; utför resursintensiva beräkningar (som omskalning av högupplösta bilder) på din klient.

För att utöka gränsen för minnesallokering i php.ini, måste du vara serverns administrator. Dessutom, .htaccess filer kan inte ändra denna konfigurationsinställning och den kan inte ändras med hjälp av ini_set(). De flera Coppermineanvändare som har webbhotell kan inte ändra på denna inställning. Om du är serverns administratör, så här gör du för att utöka minnesgränsen:
Först letar du reda på följande block i php.ini (om du faktiskt är serverns administratör):

;;;;;;;;;;;;;;;;;;;
; Resursgränser ;
;;;;;;;;;;;;;;;;;;;

max_execution_time = 30     ; Maximal processtid för varje script, i sekunder
max_input_time = 60        ; Maximal mängd tid som varje script har att analysera begärt data
memory_limit = 8M      ; Maximalt mängd minna varje script kan förbruka (8MB)

Nu utökar du minnesgränsen för att passa dina behov. 9 till 16 MB bör klara de flesta krav.