Stores a file in the database

# MongoGridFS::put

(PECL mongo >=1.0.8)

MongoGridFS::put — Stores a file in the database

### Descrierea

public MongoGridFS::put ( string `$filename` [, array `$metadata` = array() [, array `$options` = array() ]] ) : mixed

> Notă:

> MongoGridFS::put() is an alias of MongoGridFS::storeFile().

### Parametri

`filename`

  Name of the file to store.

`metadata`

  Other metadata fields to include in the file document.

  > Notă:

  > Aceste câmpuri pot să le rescrie pe cele create automat de către driver, după cum e descris în documentația de bază MongoDB pentru » colecția de fișiere. Ca un exemplu de utilizare practică a acestui comportament ar fi specificarea unor valori specifice pentru chunkSize sau _id pentru fișier.

`options`

  An array of options for the insert operations executed against the chunks and files collections. See MongoCollection::insert() for documentation on these these options.

### Valorile întoarse

Întoarce valoarea _id a fișierului cu documentul salvat. Acesta va fi un MongoId generat, doar dacă un _id nu a fost specificat în mod explicit în parametrul `metadata`.

### Erori/Excepții

Throws MongoGridFSException if there is an error reading `filename` or inserting into the chunks or files collections.

### A se vedea și

- MongoGridFS::storeBytes() - Stores a string of bytes in the database
- MongoGridFS::storeFile() - Stores a file in the database
- MongoGridFS::storeUpload() - Stores an uploaded file in the database
- MongoDB core docs on » GridFS